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内 容 提要 


atplotlib、 


Web 应 用 ， 并 帮 读 者 解决 常见 编程 问题 和 困惑 。 
本 书 适 合 对 Python 晨 Mi 感 兴趣 的 任何 层 次 的 读者 阅读 丰 。 


NumPy 和 Pygal 等 强大 的 Python 库 和 工 
、 代 码 测试 等 内 容 ; 第 二 部 分 将 理论 付 诸 实践 ， 讲解 如 何 
j 数 据 生 成 交互 式 的 信息 图 ， 以 及 创建 和 定 
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如 何 学 习 编 写 第 一 个 程序 , 每 个 程序 员 都 有 不 同 的 故事 。 我 还 是 个 孩子 时 就 开始 学 习 编 程 了 ， 
当时 我 父亲 在 计算 时 代 的 先锋 之 一 数字 设备 公司 ( Digital Equipment Corporation ) 工作 。 我 
使 用 一 台 简 陋 的 计算 机 编写 了 第 一 个 程序 , 这 台 计 算 机 是 父亲 在 家 里 的 地 下 室 组 装 而 成 的 , 它 没 
有 机 箱 , 裸露 的 主板 与 键盘 相连 ,显示 器 是 裸露 的 阴极 射线 管 。 我 编写 的 这 个 程序 是 一 款 简单 的 
猜 数 字 游 戏 ， 其 输出 类 似 于 下 面 这 样 : 


Im thinking of a number! Try to guess the number Im thinking of: 25 
Too low! Guess again: 50 
Too high! Guess again: 42 
That's it! Would you like to play again? (yes/no) no 
Thanks for playing! 


看 到 家 人 玩 着 我 编写 的 游戏 , 而 且 它 完全 按 我 预期 的 方式 运行 ,我 心里 不 知 有 多 满足 。 此 人 情 
此 景 我 永远 都 忘 不 了 。 

儿童 时 期 的 这 种 体验 一 直 影 响 我 至 今 。 现 在 , 每 当 我 通过 编写 程序 解决 了 一 个 问题 时 , 心里 
都 会 感到 非常 满足 。 相 比 于 孩提 时 期 ， 我 现在 编写 的 软件 满足 了 更 大 的 需求 , 但 通过 编写 程序 获 
得 的 满足 感 几乎 与 从 前 一 样 。 


读者 对 象 


本 书 旨 在 让 你 尽快 学 会 Python， 以 便 能 够 编写 能 正确 运行 的 程序 一 一 游戏 、 数 据 可 视 化 和 
Web 应 用 程序 ， 同 时 掌握 让 你 终身 受益 的 基本 编程 知识 。 本 书 适合 任何 年 龄 的 读者 阅读 ， 它 不 要 
求 你 有 任何 Python 编程 经 验 ， 甚 至 不 要 求 你 有 编程 经 验 。 如 果 你 想 快 速 掌 握 基本 的 编程 知识 以 便 
专注 于 开发 感 兴趣 的 项 目 , 并 想 通 过 解决 有 意义 的 问题 来 检查 你 对 新 学 概念 的 理解 程度 , 那么 本 
书 就 是 为 你 编写 的 。 本 书 还 可 供 初 中 和 高 中 教师 用 来 通过 开发 项 目 向 学 生 介绍 编程 。 


本 书 内 容 


本 书 旨 在 让 你 成 为 优秀 的 程序 员 ， 具 体 地 说 ， 是 优秀 的 Python 程序 员 。 通 过 阅读 本 书 ， 你 将 
迅速 掌握 编程 概念 , 打下 坚实 的 基础 , 并 养 成 良好 的 习惯 。 阅 读本 书后 , 你 就 可 以 开始 学 习 Python 
高 级 技术 ， 并 能 够 更 轻松 地 掌握 其 他 编程 语言 。 
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在 本 书 的 第 一 部 分 ， 你 将 学 习 编 写 Python 程序 时 需要 熟悉 的 基本 编程 概念 ， 你 刚 接触 几乎 任 
何 编程 语言 时 都 需要 学 习 这 些 概念 。 你 将 学 习 各 种 数据 以 及 在 程序 中 将 数据 存储 到 列表 和 字典 中 
的 方式 。 你 将 学 习 如 何 创建 数 据 集合 以 及 如 何 高 效 地 遍历 这 些 集合 。 你 将 学 习 使 用 while 和 if 语 
句 来 检查 条 件 , 并 在 条 件 满足 时 执行 代码 的 一 部 分 , 而 在 条 件 不 满足 时 执行 代码 的 男 一 部 分 一 一 
这 可 为 自动 完成 处 理 提供 极 大 的 帮助 。 

你 将 学 习 获 取 用 户 输 入 ,让 程序 能 够 与 用 户 交 互 ， 并 在 用 户 没 停 止 输入 时 保持 运行 状态 。 你 
将 探索 如 何 编写 函数 来 让 程序 的 各 个 部 分 可 重用 , 这 样 你 编写 执行 特定 任务 的 代码 后 , 想 使 用 它 
多 少 次 都 可 以 。 然 后 ,你 将 学 习 使 用 类 来 扩展 这 种 概念 以 实现 更 复杂 的 行为 ， 从 而 让 非常 简单 的 
程序 也 能 处 理 各 种 不 同 的 情形 。 你 将 学 习 编 写 妥 善 处 理 常 见 错误 的 程序 。 学 习 这 些 基 本 概念 后 ， 
你 就 能 编写 一 些 简短 的 程序 来 解决 一 些 明 确 的 问题 。 最 后 ， 你 将 向 中 级 编程 迈 出 第 一 步 ， 学 习 如 
何 为 代码 编写 测试 ， 以 便 在 进一步 改进 程序 时 不 用 担心 可 能 引入 bug。 第 一 部 分 介绍 的 知识 让 你 
能 够 开发 更 大 、 更 复杂 的 项 目 。 

在 第 二 部 分 , 你 将 利用 在 第 一 部 分 学 到 的 知识 来 开发 三 个 项 目 。 你 可 以 根据 自己 的 情况 ,以 
最 合适 的 顺序 完成 这 些 项 目 ; 你 也 可 以 选择 只 完成 其 中 的 某 些 项 目 。 在 第 一 个 项 目 (第 12~14 章 ) 
中 ， 你 将 创建 一 个 类 似 于 《太空 人 侵 者 》 的 射击 游戏 。 这 个 游戏 名 为 《外 星人 入 侵 》 它 包含 多 
个 难度 不 断 增 加 的 等 级 。 完 成 这 个 项 目 后 ， 你 就 能 够 自己 动手 开发 2D 游 戏 了 。 

第 二 个 项 目 (第 15~17 章 ) 介绍 数据 可 视 化 。 数 据 科学 家 的 目标 是 通过 各 种 可 视 化 技术 来 搞 
懂 海 量 信息 。 你 将 使 用 通过 代码 生成 的 数据 集 、 已 经 从 网 络 下 载 下 来 的 数据 集 以 及 程序 自动 下 载 
的 数据 集 。 完 成 这 个 项 目 后 , 你 将 能 够 编写 能 对 大 型 数据 集 进行 第 选 的 程序 ,并 以 可 视 化 方式 将 
筛选 出 来 的 数据 呈现 出 来 。 

在 第 三 个 项 目 (第 18~20 章 ) 中 ， 你 将 创建 一 个 名 为 “学 习 笔 记 ” 的 小 型 Web 应 用 程序 。 这 
个 项 目 能 够 让 用 户 将 学 到 的 与 特定 主题 相关 的 概念 记录 下 来 。 你 将 能 够 分 别 记 录 不 同 的 主题 , 还 
可 以 让 其 他 人 建立 账户 并 开始 记录 自己 的 学 习 笔 记 。 你 还 将 学 习 如 何 部 署 这 个 项 目 , 让 任何 人 都 
能 够 通过 网 络 访问 它 ， 而 不 管 他 身 处 何方 。 


为 何 使 用 Python 


继续 使 用 Python , 还 是 转 而 使 用 其 他 语言 一 一 也 许 是 编程 领域 较 新 的 语言 ? 我 每 年 都 会 考虑 
这 个 问题 。 可 我 依然 专注 于 Python， 其 中 的 原因 很 多 。Python 是 一 种 效率 极 高 的 语言 : 相 比 于 众 
多 其 他 的 语言 ， 使 用 Python 编 写 时 ， 程 序 包含 的 代码 行 更 少 。Python 的 语法 也 有 助 于 创建 整洁 的 
代码 : 相 比 其 他 语言 ， 使 用 Python 编写 的 代码 更 容易 阅读 、 调 试 和 扩展 。 

大 家 将 Python 用 于 众多 方面 : 编写 游戏 、 创 建 Web 应 用 程序 、 解 决 商业 问题 以 及 供 各 类 有 趣 
的 公司 开发 内 部 工具 。Python 还 在 科学 领域 被 大 量 用 于 学 术 研究 和 应 用 研究 。 

我 依然 使 用 Python 的 一 个 最 重要 的 原因 是 ，Python 社 区 有 形形色色 充满 激情 的 人 。 对 程序 员 
来 说 , 社区 非常 重要 ， 因 为 编程 绝 非 孤独 的 修行 。 大 多 数 程序 员 都 需要 问 解 决 过 类 似 问题 的 人 寻 
求 建议 ,经验 最 为 丰富 的 程序 员 也 不 例外 。 需 要 有 人 帮助 解决 问题 时 ， 有 一 个 联系 紧密 、 互 帮 互 
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助 的 社区 至 关 重 要 ， 而 对 于 像 你 一 样 将 Python 作 为 第 一 门 语言 来 学 习 的 人 而 言 ，Python 社 区 无 疑 
是 坚强 的 后 盾 。 
Python 是 一 门 杰出 的 语言 ， 值 得 你 去 学 习 ， 咱 们 现在 就 开始 吧 ! 
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第 一 部 分 ， 


本 书 的 第 一 部 分 介绍 编写 Python 程序 所 需要 熟悉 的 基本 概念 ， 其 


语言 ， 因 此 它们 在 


第 1 章 介绍 在 计算 机 中 安装 Python， 


你 的 整个 程序 员 生 涯 中 都 很 有 用 。 


基础 知识 


很 多 都 适用 于 所 有 编程 


世 世 


Sh 


du 


洲 小 
LU hiMb 


处 理 数据 : 只 需 几 行 代码 


不 满 


要 


ar 


第 6 章 演 示 如 何 使 


并 运行 第 一 个 程 月 已 在 屏幕 上 打印 消息 “Hello world!”。 
论述 如 何在 变量 中 存储 信息 以 及 如 何 使 用 文本 和 数字 。 


， 你 就 能 够 处 理 


0 第 4 间 介 绍 列表 。 使 用 列表 能 够 在 一 个 变量 中 存储 任意 数量 的 信息 ， 从 而 高 效 地 


2 ER 


] Python 字典 ， 将 不 同 的 信 


E 字 典 中 存储 任意 数量 的 信息 。 
第 7 章 讲解 如 何 从 用 户 那 里 于 


它 不 断 地 运行 代码 块 ， 直 到 指定 的 条 件 不 


第 5 章 讲 解 使 用 if 语句 来 编写 这 样 的 代码 : 在 特定 条 件 满足 时 采取 一 种 措施 ， 而 在 该 条 件 
足 时 采取 男 一 种 措施 。 


再 满足 为 止 。 


第 8 章 介绍 编写 函数 。 函数 是 执行 特定 人 有 


第 9 章 介 绍 类 ， 它 让 


第 10 章 介绍 如 何 使 上 


、 


保存 数据 ， 并 在 程序 再 次 


不 用 担心 引入 新 
你 必须 掌 


bug。 要 想 脱 离 初 级 程 
屋 的 基本 技能 之 一 。 


恩 关 联 起 来 。 


与 列表 一 样 ， 你 也 可 以 根据 需 


取 输 入 ， 以 让 程序 变 成 交互 式 的。 你 还 将 学 习 while 循环 ， 


FE 务 的 被 命名 的 代码 块 ,你 可 以 根据 需要 随时 运行 它 。 
你 能 够 模拟 实物 ， 如 小 狗 、 小 猫 、 人 、 汽 车 、 火 箭 等 ， 让 你 的 代码 能 
够 表示 任何 真实 或 抽象 的 东西 。 
文件 ， 以 及 如 何 处 型 


LE 错误 以 免 程 序 意 外 地 崩 演 。 你 需要 在 程序 关闭 前 
运行 时 读 取 它 们 。 你 将 学 习 Python 异常 ， 它 们 让 你 能 够 未 雨 绸 缘 ， 从 
而 让 程序 妥善 地 处 理 错误 。 
第 11 章 为 代码 编写 测 


试 ， 以 核实 程序 是 否 像 你 期 望 的 那样 工作 。 这 样 ， 扩 展 程序 时 ， 你 就 


序 员 的 阵容 ， 跻 身 于 


级 程序 员 的 行列 ， 测 试 代码 是 


在 本 章 中 ， 你 将 运行 自己 的 第 一 个 程序 一 一 hello world.py。 为 
此 ,你 首先 需要 检查 自己 的 计算 机 是 否 安 装 了 Python; 如 果 没 有 安装 ， 
你 需要 安装 它 。 你 还 要 安装 一 个 文本 编辑 器 ， 用 于 编写 和 运行 Python 
程序 。 你 输入 Python 代码 时 ， 这 个 文本 编辑 器 能 够 识别 它们 并 突出 显 
示 不 同 的 部 分 ， 让 你 能 够 轻松 地 了 解 代 码 的 结构 。 


1.1 搭建 编程 环境 


在 不 同 的 操作 系统 中 ，Python 存 在 细微 的 差别 ， 因 此 有 几 点 你 需要 牢记 在 心 。 这 里 将 介绍 大 
家 使 用 的 两 个 主要 的 Python 版 本 ， 并 简要 介绍 Python 的 安装 步骤 。 


1.1.1 Python 2 和 Python 3 


当前 ， 有 两 个 不 同 的 Python 版 本 : Python 2 和 较 新 的 Python 3。 每 种 编程 语言 都 会 随 着 新 概念 
和 新 技术 的 推出 而 不 断 发 展 ，Python 的 开发 者 也 一 直 致 力 于 丰富 和 强化 其 功能 。 大 多 数 修改 都 是 
逐步 进行 的 , 你 几乎 意识 不 到 , 但 如 果 你 的 系统 安装 的 是 Python 3, 那么 有 些 使 用 Python 2 编写 的 
代码 可 能 无 法 正确 地 运行 。 在 本 书 中 , 我 将 指出 Python 2 和 Python 3 的 重大 差别 ,这样 无 论 你 安装 
的 是 哪个 Python 版 本 ， 都 能 够 按 书 中 的 说 明 去 做 。 

如 果 你 的 系统 安装 了 这 两 个 版 本 ， 请 使 用 Python 3; 如 果 没 有 安装 Python， 请 安装 Python 3; 
如 果 只 安装 了 Python 2, 也 可 直接 使 用 它 来 编写 代码 , 但 还 是 尽快 升级 到 Python 3 为 好 ,因为 这 样 
你 就 能 使 用 最 新 的 Python 版 本 了 。 
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1.1.2 ”运行 Python 代码 片段 


Python 自 带 了 一 个 在 终端 窗口 中 运行 的 解释 器 ,让 你 无 需 保存 并 运行 整个 程序 就 能 尝试 运行 
Python 代码 片段 。 
本 书 将 以 如 下 方式 列 出 代码 片段 : 


@ >>> print("Hello Python interpreter!") 
Hello Python interpreter! 


加 粗 的 文本 表示 需要 你 输入 之 后 按 回 车 键 来 执行 的 代码 。 本 书 的 大 多 数 示 例 都 是 独立 的 小 程 
序 ， 你 将 在 编辑 器 中 执行 它们 ， 因 为 大 多 数 代码 都 是 这 样 编写 出 来 的 。 然 而 ,为 高 效 地 演示 某 基 
本 概念 ， 需 要 在 Python 终端 会 话 中 执行 一 系列 代码 片段 。 只 要 代码 清单 中 包含 三 个 尖 括 号 (如 @ 
所 示 )， 就 意味 着 输出 来 自 终 端 会 话 。 稍 后 将 演示 如 何在 Python 解释 器 中 编写 代码 。 


1.1.3 Hello World 程序 


长 期 以 来 , 编程 界 都 认为 刚 接触 一 门 新 语言 时 ,如 果 首 先 使 用 它 来 编写 一 个 在 屏幕 上 显示 消 
“Hello world!” 的 程序 ， 将 给 你 带 来 好 运 。 
要 使 用 Python 来 编写 这 种 Hello World 程 序 ， 只 需 一 行 代 码 : 


证 


print("Hello world!" 


Wt 


这 种 程序 虽然 简单 , 却 有 其 用 途 : 如 果 它 能 够 在 你 的 系统 上 正确 地 运行 , 你 编写 的 任何 Python 
程序 都 将 如 此 。 稍 后 将 介绍 如 何在 特定 的 系统 中 编写 这 样 的 程序 。 


1.2 在 不 同 操作 系统 中 搭建 Python 编程 环境 


Python 是 一 种 跨 平 台 的 编程 语言 ， 这 意味 着 它 能 够 运行 在 所 有 主要 的 操作 系统 中 。 在 所 有 安 
装 了 Python 的 现代 计算 机 上 ，, 都 能 够 运行 你 编写 的 任何 Python 程序 。 然 而 , 在 不 同 的 操作 系统 中 ， 
安装 Python 的 方法 存在 细微 的 差别 。 

在 这 一 节 中 ， 你 将 学 习 如 何在 自己 的 系统 中 安装 Python 和 运行 Hello World 程 序 。 你 首先 要 检 
查 自 己 的 系统 是 否 安装 了 Python， 如 果 没 有 ， 就 安装 它 ; 接 下 来 ,你 需要 安装 一 个 简单 的 文本 编 
辑 器 ， 并 创建 一 个 空 的 Python 文件 hello_ world.py。 最 后 ， 你 将 运行 Hello World 程 序 ， 并 排除 
各 种 故障 。 我 将 详细 介绍 如 何在 各 种 操作 系统 中 完成 这 些 任 务 , 让 你 能 够 搭建 一 个 对 初学 者 友好 
的 Python 编程 环境 。 


1.2.1 在 Linux 系统 中 搭建 Python 编程 环境 


Linux 系 统 是 为 编程 而 设计 的 ， 因 此 在 大 多 数 Linux 计 算 机 中 ， 都 默认 安装 了 Python。 编 写 和 
维护 Linux 的 人 认为 ， 你 很 可 能 会 使 用 这 种 系统 进行 编程 ， 他 们 也 鼓励 你 这 样 做 。 鉴 于 此 ， 要 在 
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这 种 系统 中 编程 ， 你 几乎 不 用 安装 什么 软件 ， 也 几乎 不 用 修改 设置 。 
1. 检查 Python 版 本 
在 你 的 系统 中 运行 应 用 程序 Terminal ( 如 果 你 使 用 的 是 Ubuntu， 可 按 Ctrl + Alt+T )， 打 开 一 


个 终端 窗口 。 为 确定 是 否 安装 了 Python ， 执 行 命令 python (请 注意 ， 其 中 的 p 是 小 写 的 )。 输 出 将 
类 似 下 面 这 样 , 它 指 出 了 安装 的 Python 版 本 ; 最 后 的 >>> 是 一 个 提示 符 , 让 你 能 够 输入 Python 命令 。 


$ python 

Python 2.7.6 (default, Mar 22 2014, 22:59:38) 

[GCC 4.8.2] on linux2 

Type "help", "copyright", "credits" or "license" for more information. 


>>> 


上 述 输出 表明 ， 当 前 计算 机 默认 使 用 的 Python 版 本 为 Python 2.7.6。 看 到 上 述 输 出 后 ， 如 果 要 
退出 Python 并 返回 到 终端 窗口 ， 可 按 Ctrl + DD 或 执行 命令 exit()。 

要 检查 系统 是 否 安装 了 Python 3， 可 能 需要 指定 相应 的 版 本 。 换 句 话 说， 如 果 输 出 指出 默认 
版 本 为 Python 2.7， 请 尝试 执行 命令 python3 : 


$ python3 

Python 3.5.0 (default, Sep 17 2015, 13:05:18) 
[GCC 4.8.4] on linux 

Type "help", "copyright", "credits" or “license” for more information. 
>>> 


上 述 输出 表明 ， 系 统 中 也 安装 了 Python 3 ， 因 此 你 可 以 使 用 这 两 个 版 本 中 的 任何 一 个 。 在 这 
种 情况 下 ， 请 将 本 书 中 的 命令 python 都 替换 为 python3。 大 多 数 Linux 系 统 都 默认 安装 了 Python ， 
但 如 果 你 的 Linux 系 统 不 知 什么 原因 没有 安装 Python 或 只 安装 了 Python 2， 而 你 要 安装 Python 3 ， 
请 参见 附录 A。 

2. 安装 文本 编辑 器 

Geany 是 一 款 简 单 的 文本 编辑 器 : 它 易于 安装 ; 让 你 能 够 直接 运行 几乎 所 有 的 程序 〈 而 无 需 
通过 终端 来 运行 ); 使 用 不 同 的 颜色 来 显示 代码 ， 以 突出 代码 语法 ; 在 终端 窗口 中 运行 代码 ， 让 
你 能 够 习惯 使 用 终端 。 附 录 B 介 绍 了 其 他 一 些 文本 编辑 器 ， 但 我 强烈 建议 你 使 用 Geany， 除 非 你 
有 充分 的 理由 不 这 样 做 。 

在 大 多 数 Linux 系 统 中 ， 都 只 需 执行 一 个 命令 就 可 以 安装 Geany: 


$ sudo apt-get install geany 


如 果 这 个 命令 不 管用 ， 请 参阅 http://geany.org/Download/ThirdPartyPackages/ 的 说 明 。 

3. 运行 Hello World 程 序 

为 编写 第 一 个 程序 ， 需 要 启动 Geany。 为 此 ， 可 按 超级 ( Super ) 键 (俗称 Windows 键 )， 并 
在 系统 中 搜索 Geany。 找 到 Geany 后 ， 双 击 以 启动 它 ; 再 将 其 拖 忠 到 任务 栏 或 桌面 上 ， 以 创建 一 
个 快捷 方式 。 接 下 来 ,创建 一 个 用 于 存储 项 目的 文件 夹 ， 并 将 其 命名 为 python_work ( 在 文件 名 
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和 文件 夹 名 中 ,最 好 使 用 小 写字 母 , 并 使 用 下 划 线 来 表示 空格 , 因为 这 是 Python 采用 的 命名 约定 )。 
回 到 Geany， 选 择 菜 单 File 》 Save As， 将 当前 的 空 Python 文件 保存 到 文件 夹 python_ work， 并 将 其 
命名 为 hello_world.py。 扩 展 名 .py 告诉 Geany， 文 件 包 含 的 是 Python 程序 ; 它 还 让 Geany 知 道 如 何 
运行 该 程序 ， 并 以 有 益 的 方式 突出 其 中 的 代码 。 

保存 文件 后 ， 在 其 中 输入 下 面 一 行 代码 : 


print("Hello Python world!") 


如 果 你 的 系统 安装 了 多 个 Python 版 本 ， 就 必须 对 Geany 进 行 配置 ， 使 其 使 用 正确 的 版 本 。 为 
此 , 可 选择 菜单 Build ( 生成 ) Set Build Commands (设置 生成 命令 ); 你 将 看 到 文字 Compile ( 编 
译 ) 和 Execute ( 执行 ), 它们 旁边 都 有 一 个 命令 。 默认 情况 下 , 这 两 个 命令 都 是 python, 要 让 Geany 
使 用 命令 python3 ， 必 须 做 相应 的 修改 。 

如 果 在 终端 会 话 中 能 够 执行 命令 python3 ,请 修改 编译 命令 和 执行 命令 , 让 Geany 使 用 Python 3 
解释 器 。 为 此 ， 将 编译 命令 修改 成 下 面 这 样 : 


python3 -m py_compile "%f" 


你 必须 完全 按 上 面 的 代码 显示 的 那样 输出 这 个 命令 ， 确 保 空格 和 大 小 写 都 完全 相同 。 
将 执行 命令 修改 成 下 面 这 样 : 


python3 "%f" 


同样 , 务必 确保 空格 和 大 小 写 都 完全 与 显示 的 相同 。 图 1-1 显 示 了 该 如 何在 Geany 中 配置 这 些 


伟 
少 


Set Build Commands 


# Label Command Working directory Reset 
Python commands 3 

1. Compile | python3 -m py_compile "%fF" | | 加 | 
| | 轩 lf | 国 | 
3. || | 国 

Error regular expression: | [|@@ 


Independent commands 


最 Make | Imake | 国 | 
2. | Make Custom Target | |make 1| 甸 | 
3. MakeObject | [make %e.o 4 [ | jl 甸 | 
4. | | 国 


Errorregular expression: | | 国 
Note: ltem 2 opens a dialog and appends the response to the command. 


Execute commands oe 
3 Execute | |python3 "%P" | |g@ 


2. | |@ 


%d, %e, %F Hp are substituted in command and directory fields, see manual for details. 


Cancel | OK 


图 1-1 在 Linux 中 配置 Geany， 使 其 使 用 Python 3 
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现在 来 运行 程序 hello_world.py。 为 此 ， 可 选择 菜单 Build 》 Execute、 单 击 Execute 图 标 ( 两 个 
齿轮 ) 或 按 F5。 将 弹出 一 个 终端 窗口 ， 其 中 包含 如 下 输出 : 


Hello Python world! 


(program exited with code: 0) 
Press return to continue 


如 果 没 有 看 到 这 样 的 输出 ， 请 检查 你 输入 的 每 个 字符 。 你 是 不 是 将 print 的 首 字母 大 写 了 ? 
是 不 是 遗漏 了 引号 或 括号 ?编程 语言 对 语法 的 要 求 非常 严格 , 只 要 你 没有 严格 遵守 语法 , 就 会 出 
错 。 如 果 代 码 都 正确 ， 这 个 程序 也 不 能 正确 地 运行 ， 请 参阅 1.3 节 。 

4. 在 终端 会 话 中 运行 Python 代码 

你 可 以 打开 一 个 终端 窗口 并 执行 命令 python 或 python3 ， 再 尝试 运行 Python 代码 片段 。 检 查 
Python 版 本 时 ， 你 就 这 样 做 过 。 下 面 再 次 这 样 做 ， 但 在 终端 会 话 中 输入 如 下 代码 行 : 


>>> print("Hello Python interpreter!") 
Hello Python interpreter! 
>>> 


消息 将 直接 打印 到 当前 终端 窗口 中 。 别 忘 了 ， 要 关闭 Python 解释 器 ， 可 按 Ctrl + DD 或 执行 命 


令 exit()。 


1.2.2 在 OS X 系 统 中 搭建 Python 编程 环境 


大 多 数 OS X 系 统 都 默认 安装 了 Python。 确 定安 装 了 Python 后 ， 你 还 需 安装 一 个 文本 编辑 需 ， 
并 确保 其 配置 正确 无 误 。 

1. 检查 是 否 安装 了 Python 

在 文件 夹 Applications/Utilities 中 ,选择 Terminal, 打开 一 个 终端 窗口 ; 你 也 可 以 按 Command + 
空格 键 ， 再 输入 terminal 并 按 回 车 。 为 确定 是 否 安 装 了 Python， 请 执行 命令 python ( 注意 ， 其 中 
的 p 是 小 写 的 )。 输 出 将 类 似 于 下 面 这 样 ， 它 指出 了 安装 的 Python 版 本 ; 最 后 的 >>> 是 一 个 提示 符 ， 
让 你 能 够 输入 Python 命令 。 


$ python 

Python 2.7.5 (default, Mar 9 2014, 22:15:05) 

[GCC 4.2.1 Compatible Apple LLVM 5.0 (clang-500.0.68)] on darwin 

Type "help", "copyright", "credits", or "license" for more information. 
>>> 


上 述 输出 表明 ， 当 前 计算 机 默认 使 用 的 Python 版 本 为 Python 2.7.5。 看 到 上 述 输 出 后 ， 如 果 要 
退出 Python 并 返回 到 终端 窗口 ， 可 按 Ctrl + D 或 执行 命令 exit()。 

要 检查 系统 是 否 安装 了 Python 3 ， 可 尝试 执行 命令 python3。 可 能 会 出 现 一 条 错误 消息 ， 但 如 
果 输 出 指出 系统 安装 了 Python 3， 则 无 需 安装 就 可 使 用 它 。 如 果 在 你 的 系统 中 能 够 执行 命令 
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python3 ， 则 对 于 本 书 的 所 有 命令 python， 都 请 替换 为 命令 python3。 如 果 不 知 道 出 于 什么 原因 你 
的 系统 没有 安装 Python， 或 者 只 安装 了 Python 2， 而 你 又 想 安 装 Python 3， 请 参阅 附录 A。 

2. 在 终端 会 话 中 运行 Python 代码 

你 可 以 打开 一 个 终端 窗口 并 执行 命令 python 或 python3 ， 再 尝试 运行 Python 代码 片段 。 检 查 
Python 版 本 时 ， 你 就 这 样 做 过 。 下 面 再 次 这 样 做 ， 但 在 终端 会 话 中 输入 如 下 代码 行 : 


>>> print("Hello Python interpreter!") 
Hello Python interpreter! 
>>> 


消息 将 直接 打印 到 当前 终端 窗口 中 。 别 忘 了 ， 要 关闭 Python 解释 器 ， 可 按 Ctrl + D 或 执行 命 
令 exit()。 

3. 安装 文本 编辑 器 

Sublime Text 是 一 款 简单 的 文本 编辑 器 : 它 在 OS X 中 易于 安装 ; 让 你 能 够 直接 运行 几乎 所 有 
程序 ( 而 无 需 通过 终端 ); 使 用 不 同 的 颜色 来 显示 代码 ， 以 突出 代码 语法 ; 在 内 内 在 Sublime Text 
窗口 内 的 终端 会 话 中 运行 代码 ， 让 你 能 够 轻松 地 查看 输出 。 附 录 B 介 绍 了 其 他 一 些 文本 编辑 器 ， 
但 我 强烈 建议 你 使 用 Sublime Text， 除 非 你 有 充分 的 理由 不 这 样 做 。 

要 下 载 Sublime Text 安 装 程序 ， 可 访问 http:/sublimetext.com/3 ， 单 击 Download 链 接 ， 并 查找 
OS X 安 装 程序 。Sublime Text 的 许可 策略 非常 灵活 ， 你 可 以 免费 使 用 这 款 编辑 器 ， 但 如 果 你 喜欢 
它 并 想 长 期 使 用 ， 建 议 你 购买 许可 证 。 下 载 安装 程序 后 ， 打 开 它 ， 再 将 Sublime Text 图 标 拖 放 到 
Applications 文 件 夹 。 

4. 配置 Sublime Text 使 其 使 用 Python 3 

如 果 你 启动 Python 终 端 会 话 时 使 用 的 命令 不 是 python, 就 需要 配置 Sublime Text, 让 它 知 道 到 
系统 的 什么 地 方 去 查找 正确 的 Python 版 本 。 要 获悉 Python 解 释 器 的 完整 路 径 ， 请 执行 如 下 命令 : 


$ type -a python3 
python3 is /usr/local/bin/python3 


现在 ， 启 动 Sublime Text， 并 选择 菜单 Tools 》 Build System New Build System， 这 将 打开 一 
个 新 的 配置 文件 。 删 除 其 中 的 所 有 内 容 ， 再 输入 如 下 内 容 : 


{ 
"cmd": ["/usr/local/bin/python3", "-u", "$file"], 


} 


这 些 代码 让 Sublime Text 使 用 命令 python3 来 运行 当前 打开 的 文件 。 请 确保 其 中 的 路 径 为 你 在 
前 一 步 使 用 命令 type -a python3 获 悉 的 路 径 。 将 这 个 配置 文件 命名 为 Python3.sublime-build， 并 
将 其 保存 到 默认 目录 一 一 你 选择 菜单 Save 时 Sublime Text 打 开 的 目录 。 

5. 运行 Hello World 程 序 

为 编写 第 一 个 程序 ， 需 要 启动 Sublime Text。 为 此 ， 可 打开 文件 夹 Applications ， 并 双击 图 标 
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Sublime Text; 也 可 按 Command + 空格 键 ， 再 在 弹出 的 搜索 框 中 输入 sublime text。 

创建 一 个 用 于 存储 项 目的 文件 夹 ， 并 将 其 命名 为 python_work ( 在 文件 名 和 文件 夹 名 中 ， 最 
好 使 用 小 写字 母 ， 并 使 用 下 划 线 来 表示 空格 ， 因 为 这 是 Python 采用 的 命名 约定 )。 在 Sublime Text 
中 ， 选 择 菜单 File 》 Save As， 将 当前 的 空 Python 文件 保存 到 文件 夹 python work， 并 将 其 命名 为 
hello_world.py。 扩 展 名 .py 告诉 Sublime Text， 文 件 包含 的 是 Python 程序 ; 它 还 让 Sublime Text 知 道 
如 何 运行 该 程序 ， 并 以 有 益 的 方式 突出 其 中 的 代码 。 

保存 文件 后 ， 在 其 中 输入 下 面 一 行 代码 : 


print("Hello Python world!") 


如 果 在 系统 中 能 够 运行 命令 python， 就 可 选择 菜单 Tools 》 Build 或 按 Ctrl + B 来 运行 程序 。 如 
果 你 对 Sublime Text 进 行 了 配置 ， 使 其 使 用 的 命令 不 是 python， 请 选择 菜单 Tools > Build System ， 
再 选择 Python 3。 这 将 把 Python 3 设置 为 默认 使 用 的 Python 版 本 ; 此 后 ， 你 就 可 选择 菜 
Tools 》 Build 或 按 Command+ B 来 运行 程序 了 。 

Sublime Text 和 窗口 底 部 将 出 现 一 个 终端 屏幕 ， 其 中 包含 如 下 输出 : 


Hello Python world! 
[Finished in 0.1s] 


如 果 没 有 看 到 这 样 的 输出 ， 请 检查 你 输入 的 每 个 字符 。 你 是 不 是 将 print 的 首 字母 大 写 了 ? 
是 不 是 遗漏 了 引号 或 括号 ?编程 语言 对 语法 的 要 求 非常 严格 , 只 要 你 没有 严格 遵守 语法 , 就 会 出 
错 。 如 果 代 码 都 正确 ， 这 个 程序 也 不 能 正确 地 运行 ， 请 参阅 1.3 节 。 


1.2.3 在 Windows 系统 中 搭建 Python 编程 环境 


Windows 系 统 并 非 都 默认 安装 了 Python， 因 此 你 可 能 需要 下 载 并 安装 它 ， 再 下 载 并 安装 一 个 
文本 编辑 需 。 

1. 安装 Python 

首先 , 检查 你 的 系统 是 否 安装 了 Python。 为 此 ,在 “开始 ”菜单 中 输入 command 并 按 回 车 以 打 
开 一 个 命令 窗口 ; 你 也 可 按 住 Shift 键 并 右 击 桌面 ， 再 选择 “在 此 处 打开 命令 窗口 ”。 在 终端 窗口 
中 输入 python 并 按 回 车 ; 如 果 出 现 了 Python 提示 符 〈>>> )， 就 说 明 你 的 系统 安装 了 Python。 然 而 ， 
你 也 可 能 会 看 到 一 条 错误 消息 ， 指 出 python 是 无 法 识别 的 命令 。 

如 果 是 这 样 ,就 需要 下 载 Windows Python 安装 程序 。 为 此 ,请 访问 http:/python.org/downloads/。 
你 将 看 到 两 个 按钮 ， 分 别 用 于 下 载 Python 3 和 Python 2。 单 击 用 于 下 载 Python 3 的 按钮 ， 这 会 根据 
你 的 系统 自动 下 载 正 确 的 安装 程序 。 下 载 安装 程序 后 ， 运 行 它 。 请 务必 选中 复 选 框 Add Python to 
PATH ( 如 图 1-2 所 示 )， 这 让 你 能 够 更 轻松 地 配置 系统 。 
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By Python 3.5.0 (32-bit) Setup 一 x "a 


| Install Python 3.5.0 (32-bit) 
Select Install Now to install Python with default settings, or choose Customize to 


enable or disable features. 


四 Install Now 


Ci\Users\matthese\AppData\LocalN\Programs\Python\Python35-32 


Includes IDLE, pip and documentation 
Creates shortcuts and file associations 


一 Customize installation 
Choose location and features 


python 


for 回 Installlauncherfor all users (recommended) 


windows 回 Add python 3.5to PATH | Cancel 


图 1-2 ”确保 选中 复 选 框 Add Python to PATH 


2. 启动 Python 终 端 会 话 
通过 配置 系统 ， 让 其 能 够 在 终端 会 话 中 运行 Python， 可 简化 文本 编辑 器 的 配置 工作 。 打 开 一 
个 命令 窗口 ， 并 在 其 中 执行 命令 python。 如 果 出 现 了 Python 提示 符 (>>> )， 就 说 明 Windows 找 到 
了 你 刚 安装 的 Python 版 本 。 


C:\> python 

Python 3.5.0 (v3.5.0:374f501f4567, Sep 13 2015, 22:15:05) [MSC v.1900 32 bit 
(Intel)] on win32 

Type "help", "copyright", "credits" or "license" for more information. 

>>> 


如 果 是 这 样 ， 就 可 以 直接 跳 到 下 一 部 分 一 一 “在 终端 会 话 中 运行 Python”。 
然而 ， 输 出 可 能 类 似 于 下 面 这 样 : 


C:\> python 
“python ”is not recognized as an internal or external command, operable 


program or batch file. 


在 这 种 情况 下 ， 你 就 必须 告诉 Windows 如 何 找 到 你 刚 安 装 的 Python 版 本 。 命 令 python 通 常 存 
储 在 C 盘 ， 因 此 请 在 Windows 资 源 管理 器 中 打开 C 盘 ， 在 其 中 找到 并 打开 以 Python 打头 的 文件 夹 ， 
再 找到 文件 python。 例 如 ,在 我 的 计算 机 中 , 有 一 个 名 为 Python35 的 文件 夹 ,其 中 有 一 个 名 为 python 
的 文件 ， 因 此 文件 python 的 路 径 为 C:\Python35\python。 如 果 找 不 到 这 个 文件 ， 请 在 Windows 资 源 
管理 器 的 搜索 框 中 输入 python， 这 将 让 你 能 够 准确 地 获悉 命令 python 在 系统 中 的 存储 位 置 。 

如 果 认 为 已 知道 命令 python 的 路 径 ， 就 在 终端 窗口 中 输入 该 路 径 进 行 测试 。 为 此 ,打开 一 个 
命令 窗口 ， 并 输入 你 确定 的 完整 路 径 : 
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C:\> C:\Python35\python 

Python 3.5.0 (v3.5.0:374f501f4567, Sep 13 2015, 22:15:05) [MSC v.1900 32 bit 
(Intel)] on win32 

Type "help", "copyright", "credits" or "license" for more information. 

>>> 


如 果 可 行 ， 就 说 明 你 已 经 知道 如 何 访问 Python 了 。 

3. 在 终端 会 话 中 运行 Python 

在 Python 会 话 中 执行 下 面 的 命令 ， 并 确认 看 到 了 输出 “Hello Python world!”。 
>>> print("Hello Python world!") 


Hello Python world! 
>>> 


每 当 要 运行 Python 代 码 片段 时 ， 都 请 打开 一 个 命令 窗口 并 启动 Python 终 端 会 话 。 要 关闭 该 终 
端 会 话 ， 可 按 Ctrl +Z， 再 按 回 车 键 ， 也 可 执行 命令 exit()。 

4. 安装 文本 编辑 器 

Geany 是 一 款 简单 的 文本 编辑 器 : 它 易于 安装 ; 让 你 能 够 直接 运行 几乎 所 有 的 程序 ( 而 无 需 
通过 终端 ); 使 用 不 同 的 颜色 来 显示 代码 ， 以 突出 代码 语法 ; 在 终端 窗口 中 运行 代码 ， 让 你 能 够 
习惯 使 用 终端 。 附 录 B 介 绍 了 其 他 一 些 文本 编辑 器 ， 但 我 强烈 建议 你 使 用 Geany， 除 非 你 有 充分 
的 理由 不 这 样 做 。 

要 下 载 Windows Geany 安 装 程序 ， 可 访问 http:/geany.org/， 单 击 Download 下 的 Releases， 找 到 
安装 程序 geany-1.2$_setup.exe 或 类 似 的 文件 。 下 载 安 装 程序 后 ， 运 行 它 并 接受 所 有 的 默认 设置 。 

为 编写 第 一 个 程序 ， 需 要 启动 Geany。 为 此 ， 可 按 超级 (Super ) 键 (俗称 Windows 键 )， 并 
在 系统 中 搜索 Geany。 找 到 Geany 后 ， 双 击 以 启动 它 ; 再 将 其 拖 蝶 到 任务 栏 或 泉 面 上 ， 以 创建 一 
个 快捷 方式 。 接 下 来 ， 创 建 一 个 用 于 存储 项 目的 文件 夹 ， 并 将 其 命名 为 python_work (在 文件 名 
和 文件 夹 名 中 ,最 好 使 用 小 写字 母 , 并 使 用 下 划 线 来 表示 空格 , 因为 这 是 Python 采用 的 命名 约定 )。 
回 到 Geany， 选 择 菜单 File 》 Save As， 将 当前 的 空 Python 文件 保存 到 文件 夹 python work， 并 将 其 
命名 为 hello_world.py。 扩 展 名 .py 告诉 Geany， 文 件 包含 的 是 Python 程序 ; 它 还 让 Geany 知 道 如 何 
运行 该 程序 ， 并 以 有 益 的 方式 突出 其 中 的 代码 。 

保存 文件 后 ， 在 其 中 输入 下 面 一 行 代码 : 


print("Hello Python world!") 


如 果 能 够 在 系统 中 执行 命令 python， 就 无 需 配 置 Geany， 因 此 你 可 以 跳 过 下 一 部 分 ， 直 接 进 
人 “运行 Hello World 程 序 ” 部 分 。 如 果 启 动 Python 解 释 器 时 必须 指定 路 径 ， 如 C:\Python3S\python ， 
请 按 下 面 的 说 明 对 Geany 进 行 配 置 。 
5. 配置 Geany 
要 配置 Geany， 请 选择 菜单 Build Set Build Commands; 你 将 看 到 文字 Compile 和 Execute, 它 
们 旁边 都 有 一 个 命令 。 默 认 情 况 下 ， 编 译 命令 和 执行 命令 的 开头 都 是 python， 但 Geany 不 知道 命 


1.2 ”在 不 同 操作 系统 中 搭建 Python 编程 环境 ”11 


令 python 存 储 在 系统 的 什么 地 方 ， 因 此 你 需要 在 其 中 添加 你 在 终端 会 话 中 使 用 的 路 径 。 
为 此 ,在 编译 命令 和 执行 命令 中 , 加 上 命令 python 所 在 的 驱动 器 和 文件 夹 。 其 中 编译 命令 应 
类 似 于 下 面 这 样 : 


C:\Python35\python -m py_compile "%f" 


在 你 的 系统 中 ， 路 径 可 能 稍 有 不 同 ， 但 请 务必 确保 空格 和 大 小 写 与 这 里 显示 的 一 致 。 
执行 命令 应 类 似 于 下 面 这 样 : 


C:\Python35\python "%f" 


同样 ， 指 定 执行 命令 时 ， 务 必 确 保 空 格 和 大 小 写 与 这 里 显示 的 一 致 。 图 1-3 显 示 了 该 如 何在 
Geany 中 配置 这 些 命令 。 


型) Set Build Commands XxX 

从 Label Command Working directory Reset 

Python commands 

t Compile C:/Python35/python -m py | | 凶 | 

2 || | [| 

3. Lint | pep8 --max-line-length=80 " | a | 
Eee Ce [C+):(10-9]+):([0-9]+) I | | [&| 

Independent commands , 

1 Make | make | | Ia | 

2. | Make Custom Target... | make | EI 

3. ”Make Object | make %e.o | 四 

4 [a | 
Error regular expression: | 色 | 

Note: ltem 2 opens a dialog and appends the response to the command. 

Execute commands 

下 | Execute ] c:/Python3 python "%6f" | 也 | 

%d, %e, %f, Wp, %l are substituted in command and directory fields, see manval for details. 

Cn |]|| ox 


图 1-3 ”在 Windows 中 配置 Geany， 使 其 使 用 Python 3 


正确 地 设置 这 些 命令 后 ， 单 击 OK 按 钮 。 

6. 运行 Hello World 程 序 

现在 应 该 能 够 成 功 地 运行 程序 了 。 请 运行 程序 hello_world.py; 为 此 ， 可 选择 菜单 
Build 》 Execute 、 单 击 Execute 图 标 ( 两 个 齿轮 ) 或 按 F5。 将 弹出 一 个 终端 窗口 ， 其 中 包含 如 下 
输出 : 
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Hello Python world! 


(program exited with code: 0) 
Press return to continue 


如 果 没 有 看 到 这 样 的 输出 ， 请 检查 你 输入 的 每 个 字符 。 你 是 不 是 将 print 的 首 字母 大 写 了 ? 
是 不 是 遗漏 了 引号 或 括号 ? 编程 语言 对 语法 的 要 求 非 常 严格 ， 只 要 你 没有 严格 遵守 语法 ， 就 会 出 
错 。 如 果 代 码 都 正确 ， 这 个 程序 也 不 能 正确 地 运行 ， 请 参阅 下 一 节 。 


1.3 ”解决 安装 问题 


如 果 你 按 前 面 的 步 又 做 ， 应 该 能 够 成 功 地 搭建 编程 环境 。 但 如 果 你 始终 无 法 运行 程序 
hello_world.py， 可 尝试 如 下 几 个 解决 方案 。 
口 程序 存在 严重 的 错误 时 ，Python 将 显示 traceback。Python 会 仔细 研究 文件 ， 试 图 找 出 其 中 
的 问题 。trackback 可 能 会 提供 线索 ， 让 你 知道 是 什么 问题 让 程序 无 法 运行 。 

口 离开 计算 机 ， 先 休息 一 会 儿 ， 再 尝试 。 别 忘 了 ， 在 编程 中 ， 语 法 非常 重要 ， 即 便 是 少 一 
个 冒号 、 引 号 不 匹配 或 括号 不 匹配 ， 都 可 能 导致 程序 无 法 正确 地 运行 。 请 再 次 阅读 本 章 
相关 的 内 容 ， 再 次 审视 你 所 做 的 工作 ， 看 看 能 和 否 找 出 错误 。 

口 推倒 重 来 。 你 也 许 不 需要 把 一 切 都 推倒 重 来 ,但 将 文件 hello_world.py 删 除 并 重新 创建 它 

也 许 是 合理 的 选择 。 

口 让 别人 在 你 的 计算 机 或 其 他 计算 机 上 按 本 章 的 步骤 重 做 一 遍 ， 并 仔细 观察 。 你 可 能 遗漏 

了 一 小 步 ， 而 别人 刚好 没有 遗漏 。 

口 请 懂 Python 的 人 帮忙 。 当 你 有 这 样 的 想法 时 ， 可 能 会 发 现在 你 认识 的 人 当中 就 有 人 使 用 

Python。 

口 本 章 的 安装 说 明 在 网 上 也 可 以 找到 ， 其 网 址 为 https:/wwwnostarch.com/pythoncrash- 

course/。 对 你 来 说 ， 在 线 版 也 许 更 合适 。 

口 到 网 上 寻求 帮助 。 附 录 C 提 供 了 很 多 在 线 资源 ， 如 论坛 或 在 线 聊 天 网 站 ， 你 可 以 前 往 这 些 
地 方 ， 请 求解 决 过 你 面临 的 问题 的 人 提供 解决 方案 。 

不 要 担心 这 会 打扰 经 验 丰 富 的 程序 员 。 每 个 程序 员 都 遇 到 过 问题 , 而 大 多 数 程 序 员 都 会 乐意 
帮助 你 正确 地 设置 系统 。 只 要 能 清晰 地 说 明 你 要 做 什么 、 尝 试 了 哪些 方法 及 其 结果 ， 就 很 可 能 
人 能 够 帮 到 你 。 正 如 前 言 中 指出 的 ，Python 社 区 对 初学 者 非常 友好 。 

任何 现代 计算 机 都 能 够 运行 Python， 如 果 你 遇 到 了 困难 ， 请 想 办 法 寻求 帮助 吧 。 前 期 的 问题 
可 能 令 人 诅 形 ,但 很 值得 你 花 时 间 去 解决 。 能 够 运行 hello_world.py 后 ， 你 就 可 以 开始 学 习 Python 
了 ， 而 且 编 程 工作 会 更 有 趣 ， 也 更 令 人 愉快 。 
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1.4 从 终端 运行 Python 程序 


你 编写 的 大 多 数 程序 都 将 直接 在 文本 编辑 器 中 运行 , 但 有 时 候 ， 从 终端 运行 程序 很 有 用 。 例 
如 ， 你 可 能 想 直 接 运 行 既 有 的 程序 。 

在 任何 安装 了 Python 的 系统 上 都 可 以 这 样 做 ， 前 提 是 你 知道 如 何 进 入 程序 文件 所 在 的 目录 。 
为 尝试 这 样 做 ， 请 确保 已 将 文件 hello world.py 存 储 到 了 桌面 的 python_work 文 件 夹 中 。 


1.4.1 在 Linux 和 OS X 系统 中 从 终端 运行 Python 程序 


在 Linux 和 OS X 系 统 中 ， 从 终端 运行 Python 程序 的 方式 相同 。 在 终端 会 话 中 ， 可 使 用 终端 命 
令 cd (表示 切换 目录 ，change directory ) 在 文件 系统 中 导航 。 命 令 1s (list 的 简写 ) 显示 当前 目录 
中 所 有 未 隐藏 的 文件 。 

为 运行 程序 hello_world.py， 请 打开 一 个 新 的 终端 窗口 ， 并 执行 下 面 的 命令 : 


@ ~$ cd Desktop/python work/ 

@ ~/Desktop/python work$ 1s 
hello world.py 

@ ~/Desktop/python work$ python hello world.py 
Hello Python world! 


这 里 使 用 了 命令 cd 来 切换 到 文件 夹 Desktop/python work ( 见 @ )。 接 下 来 ， 使 用 命令 1s 来 确 
认 这 个 文件 夹 中 包含 文件 hello world.py( 见 @ )。 最 后 ， 使 用 命令 python hello_ world.py 来 运行 
这 个 文件 ( 见 @ )。 

就 这 么 简单 。 要 运行 Python 程序 ， 只 需 使 用 命令 python ( 或 python3 ) 即 可 。 


1.4.2 在 Windows 系统 中 从 终端 运行 Python 程序 


在 命令 窗口 中 ， 要 在 文件 系统 中 导航 ， 可 使 用 终端 命令 cd; 要 列 出 当前 目录 中 的 所 有 文件 ， 
可 使 用 命令 dir (表示 目录 ， directory )。 
为 运行 程序 hello_world.py， 请 打开 一 个 新 的 终端 窗口 ， 并 执行 下 面 的 命令 : 


@ C:\> cd Desktop\python work 

@ C:\Desktop\python work> dir 
hello world.py 

四 C:\Desktop\python work> python hello world.py 
Hello Python world! 


这 里 使 用 了 命令 cd 来 切换 到 文件 夹 Desktop\python work ( 见 @ )。 接 下 来 ,使 用 命令 dir 来 确 
认 这 个 文件 夹 中 包含 文件 hello_ world.py( 见 @ )。 最 后 ， 使 用 命令 python hello_wor1d.py 来 运行 
这 个 文件 ( 见 @ )。 

如 果 你 没有 对 系统 进行 配置 以 使 用 简单 命令 python， 就 可 能 需要 指定 这 个 命令 的 路 径 : 
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C:\$ cd Desktop\python work 

C:\Desktop\python work$ dir 

hello world.py 

C:\Desktop\python work$ C:\Python35\python hello world.py 
Hello Python world! 


大 多 数 程序 都 可 以 直接 从 编辑 器 运行 ,但 需要 解决 的 问题 比较 复杂 时 ,你 编写 的 程序 可 能 需 
要 从 终端 运行 。 


动手 试 一 斌 


本 章 的 练习 都 是 探索 性 的 ,但 从 第 2 章 开 始 将 要 求 你 用 那 一 章 学 到 的 知识 来 解决 
问题 。 

1-1 python.org: 浏览 Python 主页 (http://python.org/ )， 寻 找 你 感 兴趣 的 主题 。 你 
对 Python 越 熟悉 ， 这 个 网 站 对 你 来 说 就 越 有 用 。 

1-2 输入 错误 : 打开 你 刚 创建 的 文件 hello world.py， 在 代码 中 添加 一 个 输入 错误 ， 


再 运行 这 个 程序 。 输 入 错误 会 引发 错误 吗 ? 你 能 理解 显示 的 错误 消息 吗 ? 你 能 添加 一 个 
不 会 导致 错误 的 输入 错误 吗 ? 你 赁 什么 认为 它 不 会 导致 错误 ? 
1-3 无 穷 的 技艺 : 如 果 你 编程 技艺 无 穷 ， 你 打算 开发 什么 样 的 程序 呢 ? 你 就 要 开始 
学 习 编 程 了 ; 如 果 心 中 有 目标 ， 就 能 立即 将 新 学 到 的 技能 付 诸 应 用 ; 现在 正 是 草拟 目标 
的 大 好 时 机 。 将 想法 记录 下 来 是 个 不 错 的 习惯 ， 这 样 每 当 需 要 开始 新 项 目 时 ， 都 可 参考 
它们 。 现 在 请 花 点 时 间 描 绘 三 个 你 想 创建 的 程序 。 


1.5 ”小结 


在 本 章 中 ， 你 大 致 了 解 了 Python ， 并 在 自己 的 系统 中 安装 了 Python。 你 还 安装 了 一 个 文本 编 
辑 器 ， 以 简化 Python 代码 的 编写 工作 。 你 学 习 了 如 何在 终端 会 话 中 运行 Python 代码 片段 ， 并 运行 
i hello _ world.py。 你 还 大 致 了 解 了 如 何 解决 安装 问题 。 

在 下 一 章 ， 你 将 学 习 如 何在 Python 程序 中 使 用 各 种 数据 和 变量 。 


第 2 章 


变量 和 简单 数据 类 型 


在 本 章 中 ,你 将 学 习 可 在 Python 程序 中 使 用 的 各 种 数据 ,还 将 学 
习 如 何 将 数据 存储 到 变量 中 ， 以 及 如 何在 程序 中 使 用 这 些 变 量 


2.1 运行 hello_world.py 时 发 生 的 情况 


运行 hello_world.py 时 ，Python 都 做 了 些 什么 呢 ? 下 面 来 深入 研究 一 下 。 实 际 上 ， 即 便 是 运 和 
简单 的 程序 ，Python 所 做 的 工作 也 相当 多 : 


hello_world.py 


print("Hello Python world!") 


运行 上 述 代 码 时 ， 你 将 看 到 如 下 输出 : 


Hello Python world! 


运行 文件 hello_world.py 时 ,末尾 的 .py 指出 这 是 一 个 Python 程 序 ， 因 此 编辑 器 将 使 用 Python 
解释 器 来 运行 它 。Python 解 释 器 读 取 整个 程序 , 确定 其 中 每 个 单词 的 含义 。 例 如, 看 到 单词 print 
时 ,解释 器 就 会 将 括号 中 的 内 容 打印 到 屏幕 ， 而 不 会 管 括号 中 的 内 容 是 什么 。 
编写 程序 时 ， 编 辑 器 会 以 各 种 方式 突出 程序 的 不 同 部 分 。 例 如 ， 它 知道 print 是 一 个 函数 的 
名 称 ， 因 此 将 其 显示 为 蓝 色 ; 它 知道 “Hello Python world!” 不 是 Python 代码 ， 因 此 将 其 显示 为 橙 
色 。 这 种 功能 称 为 语法 突出 ， 在 你 刚 开 始 编写 程序 时 很 有 帮助 。 
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2.2 变量 


下 面 来 尝试 在 hello_world.py 中 使 用 一 个 变量 。 在 这 个 文件 开头 添加 一 行 代码 ， 并 对 第 2 行 代 
码 进 行 修改 ， 如 下 所 示 : 


message = "Hello Python world!" 
print(message) 


运行 这 个 程序 ， 看 看 结果 如 何 。 你 会 发 现 ， 输 出 与 以 前 相同 : 


Hello Python world! 


我 们 添加 了 一 个 名 为 message 的 变量 。 每 个 变量 都 存储 了 一 个 值 一 一 与 变量 相关 联 的 信息 。 
在 这 里 ， 存 储 的 值 为 文本 “Hello Python world!”。 

添加 变量 导致 Python 解释 器 需要 做 更 多 工作 。 处 理 第 1 行 代码 时 ， 它 将 文本 “Hello Python 
world!” 与 变量 message 关 联 起 来 ; 而 处 理 第 2 行 代码 时 , 它 将 与 变量 message 关 联 的 值 打印 到 屏幕 。 

下 面 来 进一步 扩展 这 个 程序 : 修改 hello worldpy ， 使 其 再 打印 一 条 消息 。 为 此 ， 在 
hello_world.py 中 添加 一 个 空 行 ， 再 添加 下 面 两 行 代码 : 


message = "Hello Python world!" 
print(message) 


message = "Hello Python Crash Course world!" 
print(message) 


现在 如 果 运行 这 个 程序 ， 将 看 到 两 行 输 出 : 


Hello Python world! 
Hello Python Crash Course world! 


在 程序 中 可 随时 修改 变量 的 值 ， 而 Python 将 始终 记录 变量 的 最 新 值 。 


2.2.1 变量 的 命名 和 使 用 


在 Python 中 使 用 变量 时 ， 需 要 遵守 一 些 规 则 和 指南 。 违 反 这 些 规则 将 引发 错误 ， 而 指南 旨 在 
让 你 编写 的 代码 更 容易 阅读 和 理解 。 请 务必 牢记 下 述 有 关 变量 的 规则 。 
口 变量 名 只 能 包含 字母 、 数 字 和 下 划 线 。 变 量 名 可 以 字母 或 下 划 线 打头 ， 但 不 能 以 数字 打 
头 ， 例 如 ， 可 将 变量 命名 为 message 1， 但 不 能 将 其 命名 为 1 message。 
口 变量 名 不 能 包含 空格 , 但 可 使 用 下 划 线 来 分 隔 其 中 的 单词 。 例 如 , 变量 名 greeting _ message 
可 行 ， 但 变量 名 greeting message 会 引发 错误 。 
口 不 要 将 Python 关键 字 和 函数 名 用 作 变 量 名 ， 即 不 要 使 用 Python 保留 用 于 特殊 用 途 的 单词 ， 

如 print (请 参见 附录 A.4 )。 


口 变量 名 应 既 简 短 又 具有 描述 性 。 例 如 ，name 比 n 好 ，student_ name 比 s n 好 ，name_length 
比 length_ of persons_ name 好 。 
口 慎 用 小 写字 母 ] 和 大 写字 母 O， 因 为 它们 可 能 被 人 错 看 成 数字 1 和 0。 

要 创建 良好 的 变量 名 , 需要 经 过 一 定 的 实践 ,在 程序 复杂 而 有 趣 时 尤其 如 此 。 随 着 你 编写 的 
程序 越 来 越 多 ， 并 开始 阅读 别人 编写 的 代码 ， 将 越 来 越 善于 创建 有 意义 的 变量 


注意 就 目前 而 言 ， 应 使 用 小 写 的 Python 变量 名 。 在 变量 名 中 使 用 大 写字 母 虽 然 不 会 导致 错误 ， 
但 避免 使 用 大 写字 母 是 个 不 错 的 主意 。 


2.2.2 ”使 用 变量 时 避免 命名 错误 


程序 员 都 会 犯错 ， 而 且 大 多 数 程序 员 每 天 都 会 犯错 。 虽 然 优 秀 的 程序 员 也 会 犯错 , 但 他 们 也 
知道 如 何 高 效 地 消除 错误 。 下 面 来 看 一 种 你 可 能 会 犯 的 错误 ， 并 学 习 如 何 消除 它 。 

我 们 将 有 意 地 编写 一 些 引 发 错误 的 代码 。 请 输入 下 面 的 代码 , 包括 其 中 以 粗 体 显示 但 拼写 不 
正确 的 单词 mesage: 


message = "Hello Python Crash Course reader!" 
print(mesage) 


程序 存在 错误 时 , Python 解释 需 将 竭尽 所 能 地 帮助 你 找 出 问题 所 在 。 程序 无 法 成 功 地 运行 时 ， 
解释 器 会 提供 一 个 traceback。traceback 是 一 条 记录 ， 指 出 了 解释 器 尝试 运行 代码 时 ， 在 什么 地 方 
陷入 了 困境 。 下 面 是 你 不 小 心 错误 地 拼写 了 变量 名 时 ，Python 解 释 器 提供 的 traceback: 


Traceback (most recent call last): 
@ File "hello world.py", line 2, in <module> 
© print(mesage) 
四 NameError: name 'mesage' is not defined 


解释 器 指出 ， 文 件 hello_world.py 的 第 2 行 存在 错误 ( 见 @ ); 它 列 出 了 这 行 代码 ， 旨 在 帮助 你 
快速 找 出 错误 ( 见 @ ); 它 还 指出 了 它 发 现 的 是 什么 样 的 错误 ( 见 @ )。 在 这 里 ， 解 释 器 发 现 了 一 
个 名 称 错误 ， 并 指出 打印 的 变量 mesage 未 定义 : Python 无 法 识别 你 提供 的 变量 名 。 名 称 错误 通常 
意味 着 两 种 情况 : 要 么 是 使 用 变量 前 忘记 了 给 它 赋 值 ， 要 么 是 输入 变量 名 时 拼写 不 正确 。 

在 这 个 示例 中 ,第 2 行 的 变量 名 message 中 遗漏 了 字母 s。 Python 解 释 器 不 会 对 代码 做 拼写 检查 ， 
但 要 求 变量 名 的 拼写 一 致 。 例 如 ， 如 果 在 代码 的 男 一 个 地 方 也 将 message 错 误 地 拼写 成 了 mesage， 
结果 将 如 何 呢 ? 


mesage = "Hello Python Crash Course reader!" 
print (mesage) 


在 这 种 情况 下 ， 程 序 将 成 功 地 运行 : 
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Hello Python Crash Course reader! 


计算 机 一 丝 不 苟 , 但 不 关心 拼写 是 否 正确 。 因 此 , 创建 变量 名 和 编写 代码 时 ,你 无 需 考虑 英 
语 中 的 拼写 和 语法 规则 。 

很 多 编程 错误 都 很 简单 ,只 是 在 程序 的 某 一 行 输 错 了 一 个 字符 。 为 找 出 这 种 错误 而 花费 很 长 
时 间 的 大 有 人 在 。 很 多 程序 员 天 资 聪颖 、 经 验 丰富 ， 却 为 找 出 这 种 细微 的 错误 花费 数 小 时 。 你 可 
能 觉得 这 很 好 笑 ， 但 别 忘 了 ， 在 你 的 编程 生涯 中 ， 经 常会 有 同样 的 遭遇 。 


注意 ”要 理解 新 的 编程 概念 ， 最 佳 的 方式 是 尝试 在 程序 中 使 用 它们 。 如 果 你 在 做 本 书 的 练习 时 
陷入 了 困境 ， 请 尝试 做 点 其 他 的 事情 。 如 果 这 样 做 后 依然 无 法 摆脱 困境 ， 请 复习 相关 内 
容 。 如 果 这 样 做 后 情况 依然 如 故 ， 请 参阅 附录 C 的 建议 。 


动手 试 一 试 
请 完成 下 面 的 练习 ， 在 做 每 个 练习 时 ， 都 编写 一 个 独立 的 程序 。 保 存 每 个 程序 时 ， 
使 用 符合 标准 Python 约定 的 文件 名 : 使 用 小 写字 母 和 下 划 线 ， 如 Simple message.py 和 


simple messages.pyo 

2-1 简单 消息 : 将 一 条 消息 存储 到 变量 中 ， 再 将 其 打印 出 来 。 

2-2 多 条 简单 消息 : 将 一 条 消息 存储 到 变量 中 ， 将 其 打印 出 来 ; 再 将 变量 的 值 修改 
为 一 条 新 消息 ， 并 将 其 打印 出 来 。 


2.3 字符 串 

大 多 数 程序 都 定义 并 收集 某 种 数据 ， 然 后 使 用 它们 来 做 些 有 意义 的 事情 。 鉴 于 此 ， 对 数据 进 
行 分 类 大 有 神 益 。 我 们 将 介绍 的 第 一 种 数据 类 型 是 字符 串 。 字 符 串 虽然 看 似 简 单 ， 但 能 够 以 很 多 
不 同 的 方式 使 用 它们 。 

字符 串 就 是 一 系列 字符 。 在 Python 中 , 用 引号 括 起 的 都 是 字符 串 , 其 中 的 引号 可 以 是 单 引 号 ， 
也 可 以 是 双 引 号 ， 如 下 所 示 


"This is a string." 
‘This is also a string.’ 


这 种 灵活 性 让 你 能 够 在 字符 串 中 包含 引号 和 撤 号 : 


'I told my friend, "Python is my favorite languagel ” 
"The language 'Python' is named after Monty Python, not the snake." 
"One of Python's strengths is its diverse and supportive community." 


下 面 来 看 一 些 使 用 字符 串 的 方式 。 


2.3.1 使 用 方法 修改 字符 串 的 大 小 写 


对 于 字符 串 ， 可 执行 的 最 简单 的 操作 之 一 是 修改 其 中 的 单词 的 大 小 写 。 请 看 下 面 的 代码 , 并 
尝试 判断 其 作用 : 


name.py 


name = "ada lovelace" 
print(name.title()) 


将 这 个 文件 保存 为 name.py， 再 运行 它 。 你 将 看 到 如 下 输出 : 


Ada Lovelace 


在 这 个 示例 中 ， 小 写 的 字符 串 "ada lovelace" 存 储 到 了 变量 name 中 。 在 print() 语 句 中 ， 方 法 
title() 出 现在 这 个 变量 的 后 面 。 方 法 是 Python 可 对 数据 执行 的 操作 。 在 name.title() 中 ，name 后 
面 的 句点 (. ) 让 Python 对 变量 name 执 行 方法 title() 指 定 的 操作 。 每 个 方法 后 面 都 跟着 一 对 括号 ， 
这 是 因为 方法 通常 需要 额外 的 信息 来 完成 其 工作 。 这 种 信息 是 在 括号 内 提供 的 。 函 数 title() 不 
需要 额外 的 信息 ， 因 此 它 后 面 的 括号 是 空 的 。 

title() 以 首 字母 大 写 的 方式 显示 每 个 单词 ， 即 将 每 个 单词 的 首 字母 都 改 为 大 写 。 这 很 有 用 ， 
因为 你 经 常 需要 将 名 字 视 为 信息 。 例 如 ， 你 可 能 希望 程序 将 值 Ada、ADA 和 ada 视 为 同一 个 名 字 ， 
并 将 它们 都 显示 为 Ada。 

还 有 其 他 几 个 很 有 用 的 大 小 写 处 理 方法 。 例 如， 要 将 字符 串 改 为 全 部 大 写 或 全 部 小 写 ,可 以 
像 下面 这 样 做 : 


name = "Ada Lovelace" 
print(name.upper()) 
print(name.lower()) 


这 些 代 码 的 输出 如 下 : 


ADA LOVELACE 
ada lovelace 


存储 数据 时 ， 方 法 lower() 很 有 用 。 很 多 时 候 ， 你 无 法 依靠 用 户 来 提供 正确 的 大 小 写 ， 因 此 
需要 将 字符 串 先 转换 为 小 写 , 再 存储 它们 。 以 后 需要 显示 这 些 信息 时 ， 再 将 其 转换 为 最 合适 的 大 
小 写 方式 。 


2.3.2 合并 (拼接 ) 字符 串 
在 很 多 情况 下 ， 都 需要 合并 字符 串 。 例 如 ,你 可 能 想 将 姓 和 名 存储 在 不 同 的 变量 中 ,等 要 显 


A 
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示 姓 名 时 再 将 它们 合 而 为 一 : 


first name = "ada" 
last name = "lovelace" 
@ full name = first _ name + " " + last name 


print(full name) 


Python 使 用 加 号 (+ ) 来 合并 字符 串 。 在 这 个 示例 中 ， 我 们 使 用 + 来 合并 first_name、 空 格 和 
last_name， 以 得 到 完整 的 姓名 ( 见 @ )， 其 结果 如 下 : 


ada lovelace 


这 种 合并 字符 串 的 方法 称 为 拼接 。 通 过 拼接 , 可 使 用 存储 在 变量 中 的 信息 来 创建 完整 的 消息 。 
下 面 来 看 一 个 例子 : 


first name = "ada" 
last name = "lovelace" 


full name first name + " " + last name 


@ print("Hello, " + full name.title() + "!") 


在 这 里 ,一 个 问候 用 户 的 句子 中 使 用 了 全 名 ( 见 @ )， 并 使 用 了 方法 title() 来 将 姓名 设置 为 
合适 的 格式 。 这 些 代 码 显 示 一 条 格式 良好 的 简单 问候 语 : 


Hello, Ada Lovelace! 


你 可 以 使 用 拼接 来 创建 消息 ， 再 把 整 条 消息 都 存储 在 一 个 变量 中 : 


first name = "ada" 


last_name : 
full name = first name + " " + last name 


@ message = "Hello, " + full name.title() + "!" 
@ print(message 


上 述 代码 也 显示 消息 “Hello, Ada Lovelace!”， 但 将 这 条 消息 存储 在 了 一 个 变量 中 ( 见 @ )， 
这 让 最 后 的 print 语 句 简 单 得 多 ( 见 @ )。 


2.3.3 ”使 用 制 表 符 或 换行 符 来 添加 空白 


在 编程 中 , 空白 泛 指 任何 非 打印 字符 , 如 空格 、 制 表 符 和 换行 符 。 你 可 使 用 空白 来 组 织 输出 ， 


以 使 其 更 易 读 。 
要 在 字符 串 中 添加 制 表 符 ， 可 使 用 字符 组 合 \t， 如 下 述 代 码 的 @ 处 所 示 : 


>>> print("Python") 
Python 


@ >>> print("\tPython") 
Python 


要 在 字符 串 中 添加 换行 符 ， 可 使 用 字符 组 合 \n: 


>>> print("Languages:\nPython\nC\nJavaScript") 
Languages: 

Python 

C 

JavaScript 


还 可 在 同一 个 字符 串 中 同时 包含 制 表 符 和 换行 符 。 字 符 串 "\n\t" 让 Python 换 到 下 一 行 ， 并 在 
下 一 行 开头 添加 一 个 制 表 符 。 下 面 的 示例 演示 了 如 何 使 用 一 个 单行 字符 串 来 生成 四 行 输出 : 


>>> print("Languages:\n\tPython\n\tC\n\tJavaScript") 
Languages : 

Python 

C 

JavaScript 


在 接 下 来 的 两 章 中 , 你 将 使 用 为 数 不 多 的 几 行 代码 来 生成 很 多 行 输出 , 届时 制 表 符 和 换行 符 
将 提供 极 大 的 帮助 。 


2.3.4 删除 空 


在 程序 中 ， 和 额外 的 空白 可 能 令 人 迷惑 。 对 程序 员 来 说 ，' python 和 "python “看 起 来 几乎 没 
什么 两 样 ， 但 对 程序 来 说 ， 它 们 却 是 两 个 不 同 的 字符 串 。Python 能 够 发 现 'python “中 额外 的 空 
白 ， 并 认为 它 是 有 意义 的 一 一 除非 你 告诉 它 不 是 这 样 的 。 

空白 很 重要 ， 因 为 你 经 常 需要 比较 两 个 字符 串 是 否 相 同 。 例 如 ,一 个 重要 的 示例 是 , 在 用 户 
登录 网 站 时 检查 其 用 户 名 。 但 在 一 些 简单 得 多 的 情形 下 ， 人 额外 的 空格 也 可 能 令 人 迷惑 。 所 幸 在 
Python 中 ， 删 除 用 户 输 入 的 数据 中 的 多 余 的 空白 易如反掌 。 

Python 能 够 找 出 字符 串 开 头 和 末尾 多 余 的 空白 。 要 确保 字符 串 末 尾 没 有 空白 ， 可 使 用 方法 
rstrip()。 


@ >>> favorite language = 'python ' 
@ >>> favorite language 
"python ” 
@ >>> favorite language.rstrip() 
'python’ 
@ >>> favorite language 
"python ” 


存储 在 变量 favorite language 中 的 字符 串 末 尾 包含 多 余 的 空白 ( 见 @ )。 你 在 终端 会 话 中 向 
Python 询问 这 个 变量 的 值 时 ， 可 看 到 末尾 的 空格 ( 见 @ )。 对 变量 favorite_ language 调 用 方法 
rstrip() 后 ( 见 @ )， 这 个 多 余 的 空格 被 删除 了 。 然 而 ， 这 种 删除 只 是 暂时 的 ， 接 下 来 再 次 询问 


22 


Re 


第 2 章 变量 和 简单 数据 类 型 


favorite_language 的 值 时 ， 你 会 发 现 这 个 字符 串 与 输入 时 一 样 ， 依 然 包含 多 余 的 空白 ( 见 @ )。 
要 永久 删除 这 个 字符 串 中 的 空白 ， 必 须 将 删除 操作 的 结果 存 回 到 变量 中 : 


>>> favorite language = “python ' 

@ >>> favorite language = favorite language.rstrip() 
>>> favorite language 
“python 


为 删除 这 个 字符 串 中 的 空白 , 你 需要 将 其 末尾 的 空白 剔除 ,再 将 结果 存 回 到 原来 的 变量 中 ( 见 
@ )。 在 编程 中 ， 经 常 需要 修改 变量 的 值 ， 再 将 新 值 存 回 到 原来 的 变量 中 。 这 就 是 变量 的 值 可 能 


随 程序 的 运行 或 用 户 输入 数据 而 发 生变 化 的 原因 。 
你 还 可 以 剔除 字符 串 开 头 的 空 日 ， 或 同时 噜 除 字 符 串 两 端的 空 日 。 为 此 ， 可 分 别 使 用 方法 


lstrip() 和 strip(): 

@ >>> favorite language = ”python 

@ >>> favorite language.rstrip() 
" python’ 

© >>> favorite language.lstrip() 
“python 

@ >>> favorite language.strip() 
"python 


在 这 个 示例 中 ,我们 首先 创建 了 一 个 开头 和 末尾 都 有 空白 的 字符 串 〈 见 @ )。 接 下 来 ,我 们 
分 别 删除 末尾 ( 见 @ )、 开 头 〈 见 目 ) 和 两 站 ( 见 @ ) 的 空格 。 尝 试 使 用 这 些 剥 除 函 数 有 助 于 你 


熟悉 字符 囊 操 作 。 在 实际 程序 中 ， 这 些 剥 除 函 数 最 常用 于 在 存储 用 户 输入 前 对 其 进行 清理 。 


2.3.5 


使 用 字符 串 时 避免 语法 错误 


语法 错误 是 一 种 时 不 时 会 遇 到 的 错误 。 程 序 中 包含 非法 的 Python 代码 时 , 就 会 导致 语法 错误 。 
例如 ,在 用 单 引 号 括 起 的 字符 串 中 ， 如 果 包 含 撤 号 ， 就 将 导致 错误 。 这 是 因为 这 会 导致 Python 将 


第 一 个 
错误 。 


下 面 演 示 了 如 何 正 确 地 使 用 单 引号 和 双 引 号 。 请 将 该 程序 保存 为 apostrophe.py， 有 


有 引 号 和 撤 号 之 间 的 内 容 视 为 一 个 字符 串 ， 进 而 将 余下 的 文本 视 为 Python 代 码 ， 从 而 引发 


apostrophe.py 


message = "One of Python's strengths is its diverse community." 
print(message) 


撤 号 位 于 两 个 双 引 号 之 间 ， 因 此 Python 解 释 带 能 够 正确 地 理解 这 个 字符 串 : 


One 


of Python's strengths is its diverse community. 


然而 ， 如 果 你 使 用 单 引号 ，Python 将 无 法 正确 地 确定 字符 串 的 结束 位 置 : 


message = 'One of Python's strengths is its diverse community.’ 
print(message) 


而 你 将 看 到 如 下 输出 : 


File "apostrophe.py", line 1 
message = 'One of Python's strengths is its diverse community.' 
人 
© 


SyntaxError: invalid syntax 


从 上 述 输 出 可 知 ， 错 误 发 生 在 第 二 个 单 引 号 后 面 ( 见 @ )。 这 种 语法 错误 表明 ， 在 解释 顺 看 
来 ， 其 中 的 有 些 内 容 不 是 有 效 的 Python 代码 。 错 误 的 来 源 多 种 多 样 ， 这 里 指出 一 些 常见 的 。 学 习 
编写 Python 代码 时 ， 你 可 能 会 经 常 遇 到 语法 错误 。 语 法 错误 也 是 最 不 具体 的 错误 类 型 ， 因 此 可 能 
难以 找 出 并 修复 。 受 困 于 非常 环 手 的 错误 时 ， 请 参阅 附录 C 提 供 的 建议 。 


注意 ”编写 程序 时 ， 编 辑 器 的 语法 突出 功能 可 帮助 你 快速 找 出 某 些 语法 错误 。 看 到 Python 代码 
以 普通 句子 的 颜色 显示 ， 或 者 普通 句子 以 Python 代码 的 颜色 显示 时 ， 就 可 能 意味 着 文件 
中 存在 引号 不 匹配 的 情况 。 


2.3.6 Python 2 中 的 print 语句 
在 Python 2 中 ，print 语 句 的 语法 稍 有 不 同 : 


>>> python2.7 
>>> print "Hello Python 2.7 world!" 
Hello Python 2.7 world! 


在 Python 2 中 ， 无 需 将 要 打印 的 内 容 放 在 括号 内 。 从 技术 上 说 ，Python 3 中 的 print 是 一 个 也 
数 ， 因 此 括号 必 不 可 少 。 有 些 Python 2 print 语 句 也 包含 括号 ,但 其 行为 与 Python 3 中 稍 有 不 同 。 
简单 地 说 ， 在 Python 2 代码 中 ， 有 些 print 语 句 包含 括号 ， 有 些 不 包含 。 


动手 试 一 斌 
在 做 下 面 的 每 个 练习 时 ， 都 编写 一 个 独立 的 程序 ， 并 将 其 保存 为 名 称 类 似 于 
name cases.py 的 文件 。 如 果 遇 到 了 困难 ， 请 休息 一 会 儿 或 参阅 附录 C 提供 的 建议 。 


2-3 个 性 化 消息 : 将 用 户 的 姓名 存 到 一 个 变量 中 ， 并 向 该 用 户 显 示 一 条 消息 。 显 示 
的 消息 应 非常 简单 ， 如 “Hello Eric, would you like to learn some Python today?”。 

2-4 调整 名 字 的 大 小 写 : 将 一 个 人 名 存储 到 一 个 变量 中 ， 再 以 小 写 、 大 写 和 首 字母 
大 写 的 方式 显示 这 个 人 名 。 
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2-$ 名 言 : 找 一 名 你 钦佩 的 名 人 说 的 名 言 ， 将 这 个 名 人 的 姓名 和 他 的 名 言 打印 出 
来 。 输 出 应 类 似 于 下 面 这 样 (包括 引号 ): 
Albert Einstein once said, “A person who never made a mistake never tried anything 


3? 


new. 


2-6 名 言 2: 重复 练习 2-5， 但 将 名 人 的 姓名 存储 在 交 量 famous person 中 ， 再 创建 
要 显示 的 消息 ， 并 将 其 存储 在 变量 message 中， 然后 打印 这 条 消息 。 
2-7 剔除 人 名 中 的 空白 : 存储 一 个 人 名 ， 并 在 其 开头 和 末尾 都 包含 一 些 空白 字符 。 


务必 至 少 使 用 字符 组 合 "\t" 和 "\n" 各 一 次 。 
打印 这 个 人 名 ， 以 显示 其 开头 和 末尾 的 空白 。 然 后 ,分 别 使 用 别 除 函数 lstrip()、 
rstrip() 和 strip() 对 人 名 进行 处 理 ， 并 将 结果 打印 出 来 。 


2.4 数字 
在 编程 中 ， 经 常 使 用 数字 来 记录 游戏 得 分 、 表 示 可 视 化 数据 、 存 储 Web 应 用 信息 等 。Python 


根据 数字 的 用 法 以 不 同 的 方式 处 理 它 们 。 鉴 于 整数 使 用 起 来 最 简单 ， 下 面 就 先 来 看 看 Python 是 如 
何 管理 它们 的 。 


2.4.1 整数 
在 Python 中 ， 可 对 整数 执行 加 (+) 减 (-) 乘 (*) 除 (/) 运算。 


>>>2+3 
5 
>>>3 - 2 
1 
>>> 2*3 
6 
>>> 3 / 2 
1.5 


在 终端 会 话 中 ，Python 直 接 返 回 运算 


NS 
TH 
Nm 


。 了 Python 使 用 两 个 乘 号 表示 乘 方 运算 : 


>>> 10 ** 6 
1000000 


Python 还 支持 运算 次 序 ， 因 此 你 可 在 同一 个 表达 式 中 使 用 多 种 运算 。 你 还 可 以 使 用 括号 来 修 
改 运算 次 序 ， 让 Python 按 你 指定 的 次 序 执 行 运算 ， 如 下 所 示 : 
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>>> 2 + 3*4 

14 

>>> (2 + 3)*4 
20 


在 这 些 示 例 中 ,空格 不 影响 Python 计算 表达 式 的 方式 ， 它 们 的 存在 旨 在 让 你 阅读 代码 时 ， 能 
迅速 确定 先 执行 哪些 运算 。 


2.4.2 浮 点 数 


Python 将 带 小 数 点 的 数字 都 称 为 浮 点 数 。 大 多 数 编程 语言 都 使 用 了 这 个 术语 ， 它 指出 了 这 样 
一 个 事实 : 小 数 点 可 出 现在 数字 的 任何 位 置 。 每 种 编程 语言 都 须 细心 设计 , 以 妥善 地 处 理 浮 点 数 ， 
确保 不 管 小 数 点 出 现在 什么 位 置 ， 数 字 的 行为 都 是 正常 的 。 

从 很 大 程度 上 说 ， 使 用 浮 点 数 时 都 无 需 考虑 其 行为 。 你 只 需 输 入 要 使 用 的 数字 ，Python 通 常 
都 会 按 你 期 望 的 方式 处 理 它们 : 


>>>0.1 + 0.1 
0.2 
>>>0.2 + 0.2 


Oi2 
>>>2 * 0.2 
0.4 


但 需要 注意 的 是 ， 结 果 包 含 的 小 数位 数 可 能 是 不 确定 的 : 


>>> 0.2 + 0.1 
0.30000000000000004 
>>> 3 * 0.1 
0.30000000000000004 


所 有 语言 都 存在 这 种 问题 ， 没 有 什么 可 担心 的 。Python 会 尽力 找到 一 种 方式 ， 以 尽 可 能 精确 
地 表示 结果 , 但 鉴于 计算 机 内 部 表示 数字 的 方式 ， 这 在 有 些 情 况 下 很 难 。 就 现在 而 言 ， 暂 时 忽略 
多 余 的 小 数位 数 即 可 ; 在 第 二 部 分 的 项 目 中 ， 你 将 学 习 在 需要 时 处 理 多 余 小 数位 的 方式 。 
2.4.3 ”使 用 函数 str() 避 免 类 型 错误 


你 经 常 需要 在 消息 中 使 用 变量 的 值 。 例如, 假设 你 要 祝 人 生日 快乐 , 可 能 会 编写 类 似 于 下 面 
的 代码 : 


birthday.py 


age = 23 
message = "Happy " + age + "rd Birthday!" 
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print(message) 


你 可 能 认为 ， 上 述 代 码 会 打印 一 条 简单 的 生日 祝福 语 : Happy 23rd birthday!。 但 如 果 你 运行 


这 些 代 码 ， 将 发 现 它们 会 引发 错误 : 


Traceback (most recent call last): 
File "birthday.py", line 2, in <module> 
message = "Happy " + age + "rd Birthday!" 


@ TypeError: Can't convert 'int' object to str implicitly 


这 是 一 个 类 型 错误 ， 意 味 着 Python 无 法 识别 你 使 用 的 信息 。 在 这 个 示例 中 ，Python 发 现 你 使 


用 了 一 个 值 为 整数 (int ) 的 变量 ,但 它 不 知道 该 如 何 解读 这 个 值 ( 见 @ )。Python 知 道 ， 这 个 变 


量 表示 的 可 能 是 数值 23， 也 可 能 是 字符 2 和 3。 像 上 面 这 样 在 字符 串 中 使 用 整数 时 ， 需 要 显 式 地 指 
出 你 希望 Python 将 这 个 整数 用 作 字 符 串 。 为 此 , 可 调用 函数 str(),， 它 让 Python 将 非 字符 串 值 表示 
为 字符 串 : 


过 上 


你 


age = 23 
message = "Happy " + str(age) + "rd Birthday!" 


print(message) 


这 样 ，Python 就 知道 你 要 将 数值 23 转 换 为 字符 串 ， 进 而 在 生日 祝福 消息 中 显示 字符 2 和 3。 经 
述 处 理 后 ， 将 显示 你 期 望 的 消息 ， 而 不 会 引发 错误 : 


Happy 23rd Birthday! 


大 多 数 情况 下 ， 在 Python 中 使 用 数字 都 非常 简单 。 如 果 结 果 出 乎 意料 ， 请 检查 Python 是 否 按 


期 望 的 方式 将 数字 解读 为 了 数值 或 字符 串 。 


2.4.4 Python 2 中 的 整数 


在 Python 2 中 ， 将 两 个 整数 相 除 得 到 的 结果 稍 有 不 同 : 


>>> python2.7 
>>>3 /2 
1 


Python 返回 的 结果 为 1， 而 不 是 1.5。 在 Python 2 中 ， 整 数 除 法 的 结果 只 包含 整数 部 分 ,小 数 部 


分 被 删除 。 请 注意 ， 计 算 整 数 结果 时 ,采取 的 方式 不 是 四 舍 五 和 人， 而 是 将 小 数 部 分 直接 删除 。 


在 Python 2 中 ， 若 要 避免 这 种 情况 ， 务 必 确 保 至 少 有 一 个 操作 数 为 浮 点 数 ， 这 样 结果 也 将 为 


浮 点 数 : 
>>> 3 / 2 
1 


>>> 3.0 /2 
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>>> 3.0 / 2.0 
Ly5 


从 Python 3 转 而 用 Python 2 或 从 Python 2 转 而 用 Python 3 时 ， 这 种 除法 行为 常常 会 今 人 迷惑 。 


使 月 


或 编写 同时 使 用 浮 点 数 和 整数 的 代码 时 ， 一 定 要 注意 这 种 异常 行为 。 


动手 试 一 试 

2-8 数字 8: 编写 4 个 表达 式 ， 它 们 分 别 使 用 加 法 、 减 法 、 乘 法 和 除法 运算 ， 但 结 
果 都 是 数字 8。 为 使 用 print 语句 来 显示 结果 ， 务 必 将 这 些 表达 式 用 括号 括 起 来 ， 也 就 
是 说 ， 你 应 该 编写 4 行 类 似 于 下 面 的 代码 : 


print(5 + 3) 


输出 应 为 4 行 ， 其 中 每 行 都 只 包含 数字 8。 
2-9 最 喜欢 的 数字 : 将 你 最 喜欢 的 数字 存储 在 一 个 变量 中 ， 再 使 用 这 个 变量 创建 一 
条 消息 ， 指 出 你 最 喜欢 的 数字 ， 然 后 将 这 条 消息 打印 出 来 。 


2.5 注释 


在 大 多 数 编程 语言 中 ,注释 都 是 一 项 很 有 用 的 功能 。 本 书 前 面 编写 的 程序 中 都 只 包含 Python 


代码 , 但 随 着 程序 越 来 越 大 、 越 来 越 复杂 ， 就 应 在 其 中 添加 说 明 ， 对 你 解决 问题 的 方法 进行 大 至 
的 阐述 。 注 释 让 你 能 够 使 用 自然 语言 在 程序 中 添加 说 明 。 


2.5. 


1 如 何 编写 注释 
在 Python 中 ， 注 释 用 井 号 〈# ) 标识 。 井 号 后 面 的 内 容 都 会 被 Python 解 释 器 忽略 ， 如 下 所 示 : 


comment.py 


# 向 大 家 问好 
print("Hello Python people!") 


Python 解释 器 将 忽略 第 1 行 ， 只 执行 第 2 行 。 


Hello Python people! 
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小 


2.5.2 ”该 编写 什么 样 的 注释 


编写 注释 的 主要 目的 是 阐述 代码 要 做 什么 ， 以 及 是 如 何 做 的 。 在 开发 项 目 期 间 ， 你 对 各 个 痢 
分 如 何 协同 工作 了 如 指 堂 ， 但 过 段 时 间 后 ， 有 些 细 节 你 可 能 不 记得 了 。 当 然 ， 你 总 是 可 以 通过 研 
究 代码 来 确定 各 个 部 分 的 工作 原理 ,但 通过 编写 注释 ， 以 清晰 的 自然 语言 对 解决 方案 进行 概述 ， 
可 节省 很 多 时 间 。 

要 成 为 专业 程序 员 或 与 其 他 程序 员 合作 ， 就 必须 编写 有 意义 的 注释 。 当 前 ,大 多 数 软件 都 是 
合作 编写 的 ,编写 者 可 能 是 同一 家 公司 的 多 名 员工 ,也 可 能 是 众多 致力 于 同一 个 开源 项 目的 人 员 。 
训练 有 素 的 程序 员 都 希望 代码 中 包含 注释 ， 因 此 你 最 好 从 现在 开始 就 在 程序 中 添加 描述 性 注释 。 
作为 新 手 ， 最 值得 养 成 的 习惯 之 一 是 ， 在 代码 中 编写 清晰 、 简 洁 的 注释 。 

如 果 不 确定 是 否 要 编写 注释 ,就 问 问 自己 ,找到 合理 的 解决 方案 前 ,是 否 考 虑 了 多 个 解决 方 
案 。 如 果 答 案 是 肯定 的 ， 就 编写 注释 对 你 的 解决 方案 进行 说 明 吧 。 相 比 回 过 头 去 再 添加 注释 ， 删 
除 多 余 的 注释 要 容易 得 多 。 从 现在 开始 ， 本 书 的 示例 都 将 使 用 注释 来 阐述 代码 的 工作 原理 。 
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2-10 添加 注释 : 选择 你 编写 的 两 个 程序 ， 在 每 个 程序 中 都 至 少 添加 一 条 注释 。 如 


果 程 序 太 简 单 ,实在 没有 什么 需要 说 明 的 ,就 在 程序 文件 开头 加 上 你 的 姓名 和 当前 日 期 ， 
再 用 一 句 话 阐 述 程 序 的 功能 。 


2.6 Python 之 禅 


编程 语言 Perl 曾 在 互联 网 领域 长 期 占据 着 统治 地 位 ， 早 期 的 大 多 数 交 互 式 网 站 使 用 的 都 是 
Perl 脚 本 。 彼 时 , “解决 问题 的 办 法 有 多 个 ”被 Perl 社 区 奉 为 座右铭 。 这 种 理念 一 度 深 受 大 家 的 喜 
爱 ， 因 为 这 种 语言 固有 的 灵活 性 使 得 大 多 数 问 题 都 有 很 多 不 同 的 解决 之 道 。 在 开发 项 目 期 间 ， 这 
种 灵活 性 是 可 以 接受 的 , 但 大 家 最 终 认 识 到 ,过 于 强调 灵活 性 会 导致 大 型 项 目 难以 维护 : 要 通过 
研究 代码 搞 清 楚 当 时 解决 复杂 问题 的 人 是 怎么 想 的 ， 既 困难 又 麻烦 ， 还 会 耗费 大 量 的 时 间 。 

经 验 丰 富 的 程序 员 倡导 尽 可 能 避 繁 就 简 。Python 社 区 的 理念 都 包含 在 Tim Peters 撰 写 的 
“Python 之 禅 ” 中 。 要 获悉 这 些 有 关 编 写 优秀 Python 代 码 的 指导 原则 ， 只 需 在 解释 器 中 执行 命令 
import this。 这 里 不 打算 歼 述 整个 “Python 之 禅 ”， 而 只 与 大 家 分 享 其 中 的 几 条 原则 ， 让 你 明白 
为 何 它 们 对 Python 新 手 来 说 至 关 重 要 。 


>>> import this 
The Zen of Python, by Tim Peters 


Beautiful is better than ugly. 
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Python 程 序 员 笃信 代码 可 以 编写 得 漂亮 而 优雅 。 编 程 是 要 解决 问题 的 ,设计 良好 、 高 效 而 漂 
亮 的 解决 方案 都 会 让 程序 员 心 生 敬 意 。 随 着 你 对 Python 的 认识 越 来 越 深 入 ， 并 使 用 它 来 编写 越 来 
越 多 的 代码 ， 有 一 天 也 许 会 有 人 站 在 你 后 面 惊 呼 :“ 哇 ， 代 码 编 写 得 真是 漂亮 1” 


Simple is better than complex. 


如 果 有 两 个 解决 方案 , 一 个 简单 ,一 个 复杂 ,但 都 行 之 有 效 ， 就 选择 简单 的 解决 方案 吧 
样 ， 你 编写 的 代码 将 更 容易 维护 ， 你 或 他 人 以 后 改进 这 些 代码 时 也 会 更 容易 。 


这 


Complex is better than complicated. 


现实 是 复杂 的 ， 有 时 候 可 能 没有 简单 的 解决 方案 。 在 这 种 情况 下， 就 选择 最 简单 可 行 的 解决 


Readability counts. 


即便 是 复杂 的 代码 ， 也 要 让 它 易于 理解 。 开 发 的 项 目 涉及 复杂 代码 时 ,一定 要 为 这 些 代 码 编 
写 有 益 的 注释 。 


There should be one-- and preferably only one --obvious way to do it. 


如 果 让 两 名 Python 程 序 员 去 解决 同一 个 问题 ,他 们 提供 的 解决 方案 应 大 致 相同 。 这 并 不 是 说 
编程 没有 创意 空间 ， 而 是 恰恰 相反 ! 然而 , 大 部 分 编程 工作 都 是 使 用 常见 解决 方案 来 解决 简单 的 
小 问题 , 但 这 些小 问题 都 包含 在 更 庞大 、 更 有 创意 空间 的 项 目 中 。 在 你 的 程序 中 , 各 种 具体 细 闻 
对 其 他 Python 程 序 员 来 说 都 应 易于 理解 。 


Now is better than never. 


你 可 以 将 余生 都 用 来 学 习 Python 和 编程 的 纷繁 难民 之 处 , 但 这 样 你 什么 项 目 都 完 不 成 。 不 要 
企图 编写 完美 无 缺 的 代码 ; 先 编写 行 之 有 效 的 代码 ,再 决 定 是 对 其 做 进一步 改进 ,还 是 转 而 去 纺 
写 新 代码 。 

等 你 进入 下 一 章 ， 开 始 研究 更 复杂 的 主题 时 ， 务 必 牢 记 这 种 简约 而 清晰 的 理念 。 如 此 ， 经 
验 丰富 的 程序 员 定 将 对 你 编写 的 代码 心 生 敬 意 ， 进 而 乐意 向 你 提供 反馈 ， 并 与 你 合作 开发 有 趣 
的 项 目 。 


动手 试 一 斌 


2-11 Python 之 禅 : 在 Python 终端 会 话 中 执行 命令 import this， 并 粗略 地 浏览 一 下 
其 他 的 指导 原则 。 
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2.7 小 结 


在 本 章 中 ,你 学 习 了 : 如 何 使 用 变量 ; 如 何 创建 描述 性 变量 名 以 及 如 何 消 除名 称 错误 和 语法 
错误 ; 字符 串 是 什么 ,以 及 如 何 使 用 小 写 、 大 写 和 首 字母 大 写 方式 显示 字符 串 ; 使 用 空白 来 显示 
整洁 的 输出 ， 以 及 如 何 剔除 字符 串 中 多 余 的 空白 ; 如 何 使 用 整数 和 浮 点 数 ; 使 用 数值 数据 时 需要 
注意 的 意外 行为 。 你 还 学 习 了 如 何 编写 说 明 性 注释 , 让 代码 对 你 和 其 他 人 来 说 更 容易 理解 。 最后， 
你 了 解 了 让 代码 尽 可 能 简单 的 理念 。 

在 第 3 章 ， 你 将 学 习 如 何在 被 称 为 列表 的 变量 中 存储 信息 集 ， 以 及 如 何 通 过 遍历 列表 来 操作 
其 中 的 信息 。 


列表 简介 


在 本 章 和 下 一 章 中 ， 你 将 学 习 列 表 是 什么 以 及 如 何 使 用 列表 元 
素 , 列表 让 你 能 够 在 一 个 地 方 存储 成 组 的 信息 , 其 中 可 以 只 包含 几 个 
元 素 , 也 可 以 包含 数 百 万 个 元 素 。 列表 是 新 手 可 直接 使 用 的 最 强大 的 
Python 功能 之 一 ， 它 融合 了 众多 重要 的 编程 概念 。 


3.1 列表 是 什么 


列表 由 一 系列 按 特 定 顺序 排列 的 元 素 组 成 。 你 可 以 创建 包含 字母 表 中 所 有 字母 、 数 字 0-~9 或 
所 有 家 庭 成 员 姓名 的 列表 ; 也 可 以 将 任何 东西 加 入 列表 中 ， 其 中 的 元 素 之 间 可 以 没有 任何 关系 。 
鉴于 列表 通常 包含 多 个 元 素 ， 给 列表 指定 一 个 表示 复数 的 名 称 〈 如 letters、digits 或 names ) 是 
个 不 错 的 主意 。 

在 Python 中 ， 用 方 括号 ([] ) 来 表示 列表 ， 并 用 逗号 来 分 隔 其 中 的 元 素 。 下 面 是 一 个 简单 的 
列表 示例 ， 这 个 列表 包含 几 种 自行 车 : 


bicycles.py 


bicycles = ['trek', 'cannondale', 'redline', "specialized '] 
print(bicycles) 


如 果 你 让 Python 将 列表 打印 出 来 ，Python 将 打印 列表 的 内 部 表示 ， 包 括 方 插 号 : 


['trek', 'cannondale', 'redline', 'specialized'|] 


鉴于 这 不 是 你 要 让 用 户 看 到 的 输出 ， 下 面 来 学 习 如 何 访问 列表 元 素 。 
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3.1.1 访问 列表 元 素 


列表 是 有 序 集合 , 因此 要 访问 列表 的 任何 元 素 , 只 需 将 该 元 素 的 位 置 或 索引 告诉 Python 即 可 。 
要 访问 列表 元 素 ， 可 指出 列表 的 名 称 ， 再 指出 元 素 的 索引 ， 并 将 其 放 在 方 括号 内 。 
例如 ， 下 面 的 代码 从 列表 picycles 中 提取 第 一 款 自 行车 : 


bicycles ['trek', 'cannondale', 'redline', 'specialized'] 
@ print(bicycles[0]) 


@ 处 演示 了 访问 列表 元 素 的 语法 。 当 你 请 求 获取 列表 元 素 时 ，Python 只 返回 该 元 素 ， 而 不 包 
括 方 括号 和 引号 : 


trek 


这 正 是 你 要 让 用 户 看 到 的 结果 一 一 整洁 、 干 净 的 输出 。 
你 还 可 以 对 任何 列表 元 素 调 用 第 2 章 介 绍 的 字符 串 方 法 。 例 如 ， 可 使 用 方法 title() 让 元 素 
'trek' 的 格式 更 整洁 : 


bicycles ['trek', 'cannondale', 'redline', 'specialized' 
print(bicycles[0].title()) 


这 个 示例 的 输出 与 前 一 个 示例 相同 ， 只 是 首 字母 T 是 大 写 的 。 
3.1.2 索引 从 0 而 不 是 1 开始 


在 Python 中 ， 第 一 个 列表 元 素 的 索引 为 0， 而 不 是 1。 在 大 多 数 编程 语言 中 都 是 如 此 ， 这 与 列 
表 操 作 的 底层 实现 相关 。 如 果 结 果 出 乎 意料 ， 请 看 看 你 是 否 犯 了 简单 的 差 一 错误 。 

第 二 个 列表 元 素 的 索引 为 1。 根 据 这 种 简单 的 计数 方式 ， 要 访问 列表 的 任何 元 素 ， 都 可 将 其 
位 置 减 1， 并 将 结果 作为 索引 。 例 如 ， 要 访问 第 四 个 列表 元 素 ， 可 使 用 索引 3。 

下 面 的 代码 访问 索引 1 和 3 处 的 自行 车 : 


bicycles = ['trek', 'cannondale', 'redline', 'specialized'] 
print(bicycles[1]) 
print(bicycles[3]) 


这 些 代 码 返 回 列表 中 的 第 二 个 和 第 四 个 元 素 : 


cannondale 
specialized 


Python 为 访问 最 后 一 个 列表 元 素 提供 了 一 种 特殊 语法 。 通 过 将 索引 指定 为 -1， 可 让 Python 返 
回 最 后 一 个 列表 元 素 : 


bicycles = ['trek', 'cannondale', 'redline', " Specialized 
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print(bicycles[-1]) 


这 些 代 码 返 回 'specialized' 。 这 种 语法 很 有 用 ， 因 为 你 经 常 需要 在 不 知道 列表 长 度 的 情况 
下 访问 最 后 的 元 素 。 这 种 约定 也 适用 于 其 他 负数 索引 ， 例 如 ， 索 引 -2 返回 倒数 第 二 个 列表 元 素 ， 
索引 -3 返回 倒数 第 三 个 列表 元 素 ， 以 此 类 推 。 


3.1.3 ”使 用 列表 中 的 各 个 值 


可 像 使 用 其 他 变量 一 样 使 用 列表 中 的 各 个 值 。 例 如 , 你 可 以 使 用 拼接 根据 列表 中 的 值 来 创建 
消息 。 
下 面 来 尝试 从 列表 中 提取 第 一 款 自行 车 ， 并 使 用 这 个 值 来 创建 一 条 消息 : 


bicycles ['trek', 'cannondale', 'redline', 'specialized'| 
@ message = "My first bicycle was a " + bicycles[0].title() + "." 


print(message) 


我 们 使 用 bicycles[0] 的 值 生 成 了 一 个 句子 , 并 将 其 存储 在 变量 message 中 ( 见 @ ), 输出 是 一 
个 简单 的 句子 ， 其 中 包含 列表 中 的 第 一 款 自 行车 : 


My first bicycle was a Trek. 


动手 试 一 试 

请 尝试 编写 一 些 简短 的 程序 来 完成 下 面 的 练习 ， 以 获得 一 些 使 用 Python 列表 的 第 
一 手 经 验 。 你 可 能 需要 为 每 章 的 练习 创建 一 个 文件 夹 ， 以 整洁 有 序 的 方式 存储 为 完成 各 
章 的 练习 而 编写 的 程序 。 

3-1 姓名 : 将 一 些 朋 友 的 姓名 存储 在 一 个 列表 中 ， 并 将 其 命名 为 names。 依 次 访问 


该 列表 中 的 每 个 元 素 ， 从 而 将 每 个 朋友 的 姓名 都 打印 出 来 。 

3-2 问候 语 : 继续 使 用 练习 3-1 中 的 列表 ， 但 不 打印 每 个 朋友 的 姓名 ， 而 为 每 人 打 
印 一 条 消息 。 每 条 消息 都 包含 相同 的 问候 语 ， 但 抬头 为 相应 朋友 的 姓名 。 

3-3 自己 的 列表 : 想 想 你 喜欢 的 通勤 方式 ， 如 骑 摩 托 车 或 开 汽车 ， 并 创建 一 个 包含 
多 种 通勤 方式 的 列表 。 根 据 该 列表 打印 一 系列 有 关 这 些 通勤 方式 的 宣言 , 如 “Twould like 
to own a Honda motorcycle 。 


3.2 修改、 添加 和 删除 元 素 
你 创建 的 大 多 数列 表 都 将 是 动态 的 ， 这 意味 着 列表 创建 后 ,将 随 着 程序 的 运行 增删 元 素 。 例 
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如 ,你 创建 一 个 游戏 ,要求 玩家 射 杀 从 天 而 降 的 外 星人 ; 为 此 ,可 在 开始 时 将 一 些 外 星人 存储 在 
列表 中 ,然后 每 当 有 外 星人 被 射 杀 时 ,都 将 其 从 列表 中 删除 ,而 每 次 有 新 的 外 星人 出 现在 屏幕 上 
时 ， 都 将 其 添加 到 列表 中 。 在 整个 游戏 运行 期 间 ， 外 星人 列表 的 长 度 将 不 断 变 化 。 


3.2.1 修改 列表 元 素 


修改 列表 元 素 的 语法 与 访问 列表 元 素 的 语法 类 似 。 要 修改 列表 元 素 , 可 指定 列表 名 和 要 修改 
的 元 素 的 索引 ， 再 指定 该 元 素 的 新 值 。 
例如 ， 假 设 有 一 个 摩托 车 列表 ， 其 中 的 第 一 个 元 素 为 "honda' ， 如 何 修改 它 的 值 呢 ? 


motorcycles.py 


@ motorcycles = ['honda', 'yamaha', "Suzuki ' 
print(motorcycles) 


@ motorcycles[0] = 'ducati' 
print(motorcycles) 
我 们 首先 定义 一 个 摩托 车 列表 ， 其 中 的 第 一 个 元 素 为 'honda'( 见 @ )。 接 下 来 ,我 们 将 第 一 
个 元 素 的 值 改 为 'ducati'( 见 @ )。 输出 表明 ， 第 一 个 元 素 的 值 确实 变 了 ,但 其 他 列表 元 素 的 值 


没 变 : 


[ honda ， 'yamaha', 'suzuki'] 
['ducati', "yamaha " ， 'suzuki'] 


你 可 以 修改 任何 列表 元 素 的 值 ， 而 不 仅仅 是 第 一 个 元 素 的 值 。 


3.2.2 ”在 列表 中 添加 元 素 


你 可 能 出 于 众多 原因 要 在 列表 中 添加 新 元 素 , 例如 ,你 可 能 希望 游戏 中 出 现 新 的 外 星人 、 添 
加 可 视 化 数据 或 给 网 站 添加 新 注册 的 用 户 。Python 提 供 了 多 种 在 既 有 列表 中 添加 新 数据 的 方式 。 

1. 在 列表 末尾 添加 元 素 

在 列表 中 添加 新 元 素 时 ， 最 简单 的 方式 是 将 元 素 附 加 到 列表 末尾 。 给 列表 附加 元 素 时 ， 它 将 
添加 到 列表 未 尾 。 继 续 使 用 前 一 个 示例 中 的 列表 ， 在 其 末尾 添加 新 元 素 'ducati ' : 


motorcycles = [ honda ， "yamaha ， ' Suzuki |] 
print(motorcycles) 


@ motorcycles.append(' ducati') 
print(motorcycles) 


方法 append() 将 元 素 'ducati' 添 加 到 了 列表 末尾 ( 见 @ )， 而 不 影响 列表 中 的 其 他 所 有 元 素 : 


['honda', 'yamaha', 'suzuki'] 
['honda'’, 'yamaha', 'suzuki', 'ducati'] 
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方法 append() 让 动态 地 创建 列表 易如反掌 ， 例如， 你 可 以 先 创建 一 个 空 列表 ， 再 使 用 一 系列 的 
append() 语 句 添 加 元 素 。 下 面 来 创建 一 个 空 列表 , 再 在 其 中 添加 元 素 'honda' 、'yamaha' 和"'suzuki ' : 


motorcycles = [|] 


motorcycles.append('honda') 
motorcycles.append('yamaha') 
motorcycles.append(' suzuki') 


print (motorcycles) 


最 终 的 列表 与 前 述 示 例 中 的 列表 完全 相同 : 


['honda', 'yamaha', 'suzuki'] 


这 种 创建 列表 的 方式 极其 常见 , 因为 经 常 要 等 程序 运行 后 , 你 才 知道 用 户 要 在 程序 中 存储 哪 
些 数 据 。 为 控制 用 户 ， 可 首先 创建 一 个 空 列表 ,用 于 存储 用 户 将 要 输入 的 值 ， 然 后 将 用 户 提供 的 
每 个 新 值 附 加 到 列表 中 。 
2. 在 列表 中 插入 元 素 
使 用 方法 insert() 可 在 列表 的 任何 位 置 添加 新 元 素 。 为 此 ， 你 需要 指定 新 元 素 的 索引 和 值 。 


motorcycles = 


‘honda', 'yamaha' , 'suzuki'] 


@ motorcycles.insert(0, 'ducati') 
print(motorcycles) 


在 这 个 示例 中 , 值 ' ducati' 被 扣 
并 将 值 ' ducati' 存 


入 到 了 列表 开头 ( 见 @ ); 方法 insert() 在 索引 0 处 添加 空间 ， 
赃 到 这 个 地 方 。 这 种 操作 将 列表 中 既 有 的 每 个 元 素 都 右 移 一 个 位 置 : 


['ducati', "honda ， "yamaha ， 'suzuki'] 


3.2.3 ”从 列表 中 删除 元 素 


你 经 常 需要 从 列表 中 删除 一 个 或 多 个 元 素 。 例 如 ， 玩 家 将 空中 的 一 个 外 星人 射 杀 后 ， 你 很 可 
能 要 将 其 从 存活 的 外 星人 列表 中 删除 ; 当 用 户 在 你 创建 的 Web 应 用 中 注销 其 账户 时 ， 你 需要 将 该 
用 户 从 活跃 用 户 列表 中 删除 。 你 可 以 根据 位 置 或 值 来 删除 列表 中 的 元 素 。 

1. 使 用 de1 语 句 删除 元 素 


如 果 知 道 要 删除 的 元 素 在 列表 中 的 位 置 ， 可 使 用 de1 语 句 。 


motorcycles = ['honda', 'yamaha', 'suzuki'] 
print (motorcycles) 


@ del motorcycles[0] 
print(motorcycles) 


36 第 3 章 列表 简介 


@ 处 的 代码 使 用 del 删 除了 列表 motorcycles 中 的 第 一 个 元 素 一 一 'honda': 


['honda', 'yamaha', 'suzuki'] 
['yamaha' , 'suzuki'] 


使 用 del 可 删除 任何 位 置 处 的 列表 元 素 ， 条件 是 知道 其 索引 。 下 例 演示 了 如 何 删 除 前 述 列表 
中 的 第 二 个 元 素 一 一 'yamaha ' : 


motorcycles = [ honda` ， "yamaha ， 'suzuki'] 
print(motorcycles) 


del motorcycles[1] 
print(motorcycles) 


下 面 的 输出 表明 ， 已 经 将 第 二 款 摩托 车 从 列表 中 删除 了 : 


onda', 'yamaha' , 'suzuki 
‘honda', ‘yamaha', i 
['honda' , 'suzuki'] 


在 这 两 个 示例 中 ， 使 用 del 语 句 将 值 从 列表 中 删除 后 ， 你 就 无 法 再 访问 它 了 。 

2. 使 用 方法 pop() 删 除 元 素 

有 时候, 你 要 将 元 素 从 列表 中 删除 ， 并 接着 使 用 它 的 值 。 例 如 ,你 可 能 需要 获取 刚 被 射 杀 的 
外 星人 的 x 和 和 y 坐 标 ， 以 便 在 相应 的 位 置 显示 爆炸 效果 ; 在 Web 应 用 程序 中 ， 你 可 能 要 将 用 户 从 活 
跃 成 员 列 表 中 删除 ， 并 将 其 加 入 到 非 活 跃 成 员 列 表 中 。 

方法 pop() 可 删除 列表 末尾 的 元 素 ， 并 让 你 能 够 接着 使 用 它 。 术 语 弹 出 ( pop ) 源 自 这 样 的 类 
比 : 列表 就 像 一 个 栈 ， 而 删除 列表 末尾 的 元 素 相 当 于 弹出 栈 顶 元 素 。 

下 面 从 列表 motorcycles 中 弹出 一 款 摩托 车 : 


@ motorcycles = ['honda', 'yamaha', "Suzuki 
print(motorcycles) 


@ popped motorcycle = motorcycles.pop() 
@ print(motorcycles) 
@ print(popped motorcycle) 
我 们 首先 定义 并 打印 了 列表 motorcycles( 见 @ )。 接 下 来 ， 我 们 从 这 个 列表 中 弹出 一 个 值 ， 
并 将 其 存储 到 变量 popped_motorcycle 中 ( 见 @ )。 然 后 我 们 打印 这 个 列表 ， 以 核实 从 其 中 删除 了 
一 个 值 ( 见 日 )。 最 后 ， 我 们 打印 弹出 的 值 ， 以 证 明 我 们 依然 能 够 访问 被 删除 的 值 ( 见 @ )。 
输出 表明 ， 列 表 末 尾 的 值 ' suzuki ' 已 删除 ， 它 现在 存储 在 变量 popped_motorcycle 中 : 


[ honda ， "yamaha ` ， 'suzuki'] 

[ honda ， "yamaha '] 

suzuki 

方法 pop() 是 怎么 起 作用 的 呢 ? 假设 列表 中 的 摩托 车 是 按 购 买 时 间 存 储 的 ， 就 可 使 用 方法 
pop() 打 印 一 条 消息 ， 指 出 最 后 购买 的 是 哪 款 摩托 车 : 
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motorcycles = ['honda', 'yamaha', 'suzuki'] 


last owned = motorcycles.pop() 
print("The last motorcycle I owned was a " + last owned.title() + ".") 


输出 是 一 个 简单 的 句子 ， 指 出 了 最 新 购买 的 是 哪 款 摩托 车 : 


The last motorcycle I owned was a Suzuki. 


3. 弹出 列表 中 任何 位 置 处 的 元 素 
实际 上 ， 你 可 以 使 用 pop() 来 删除 列表 中 任何 位 置 的 元 素 ， 只 需 在 括号 中 指定 要 删除 的 元 素 
的 索引 即 可 。 


motorcycles = [ honda ` ， "yamaha ， "Suzuki |] 


@ first owned = motorcycles.pop(0) 
@ print('The first motorcycle I owned was a ' + first owned.title() + '.') 


首先 ,我们 弹出 了 列表 中 的 第 一 款 摩托 车 ( 见 @ )， 然 后 打印 了 一 条 有 关 这 辆 摩托 车 的 消息 
( 见 @ )。 输 出 是 一 个 简单 的 句子 ， 描 述 了 我 购买 的 第 一 辆 摩托 车 : 


The first motorcycle I owned was a Honda. 


别 忘 了 ， 每 当 你 使 用 pop() 时 ， 被 弹出 的 元 素 就 不 再 在 列表 中 了 。 

如 果 你 不 确定 该 使 用 del 语 句 还 是 pop() 方 法 ,下 面 是 一 个 简单 的 判断 标准 : 如 果 你 要 从 列表 
中 删除 一 个 元 素 ， 且 不 再 以 任何 方式 使 用 它 ， 就 使 用 de1 语 句 ; 如 果 你 要 在 删除 元 素 后 还 能 继续 
使 用 它 ， 就 使 用 方法 pop()。 

4. 根据 值 删除 元 素 

有 时 候 ， 你 不 知道 要 从 列表 中 删除 的 值 所 处 的 位 置 。 如 果 你 只 知道 要 删除 的 元 素 的 值 ,可 使 
用 方法 remove()。 

例如 ， 假 设 我 们 要 从 列表 motorcycles 中 删除 值 ' ducati'。 


motorcycles = ['honda', 'yamaha', 'suzuki', 'ducati'] 
print(motorcycles) 


@ motorcycles.Temove( ducati') 
print(motorcycles) 


@ 处 的 代码 让 Python 确 定 'ducati' 出 现在 列表 的 什么 地 方 ， 并 将 该 元 素 删 除 : 


['honda', 'yamaha', 'suzuki', 'ducati'] 
['honda', 'yamaha', 'suzuki'] 


使 用 remove() 从 列表 中 删除 元 素 时 ， 也 可 接着 使 用 它 的 值 。 下 面 删 除 值 ' ducati' ， 并 打印 一 
条 消息 ， 指 出 要 将 其 从 列表 中 删除 的 原因 : 
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@ motorcycles = ['honda', 'yamaha', 'suzuki', 'ducati'] 
print(motorcycles) 


@ too expensive = 'ducati' 
@ motorcycles.remove(too expensive) 
print(motorcycles) 
@ print("\nA " + too expensive.title() + "is too expensive for me.") 


在 @ 处 定义 列表 后 ， 我 们 将 值 ' ducati' 存 储 在 变量 too_expensive 中 ( 见 @ )。 接 下 来 ,我 们 
使 用 这 个 变量 来 告诉 Python 将 哪个 值 从 列表 中 删除 ( 见 @ )。 最 后 , 值 ' ducati' 已 经 从 列表 中 删除 ， 


但 它 还 存储 在 变量 too_expensive 中 ( 见 @ )， 让 我 们 能 够 打印 一 条 消息 ， 指 出 将 'ducati' 从 列表 
motorcycles 中 删除 的 原因 : 


[ honda' ， "yamaha ， 'suzuki', "ducati ] 
[ honda ， "yamaha ， 'suzuki'] 


A Ducati is too expensive for me. 


注意 “方法 remove() 只 删除 第 一 个 指定 的 值 。 如 果 要 删除 的 值 可 能 在 列表 中 出 现 多 次 ， 就 需要 
使 用 循环 来 判断 是 否 删除 了 所 有 这 样 的 值 。 你 将 在 第 7 章 学 习 如 何 这 样 做 。 


动手 试 一 斌 


下 面 的 练习 比 第 2 章 的 练习 要 复杂 些 , 但 让 你 有 机 会 以 前 面 介 绍 过 的 各 种 方式 使 用 
列表 。 
3-4 嘉宾 名 单 : 如 果 你 可 以 邀请 任何 人 一 起 共 进 晚餐 ( 无 论 是 在 世 的 还 是 故去 的 )， 
你 会 邀请 哪些 人 ? 请 创建 一 个 列表 ， 其 中 包含 至 少 3 个 你 想 邀 请 的 人 ; 然后 , 使 用 这 个 
列表 打印 消息 ， 邀 请 这 些 人 来 与 你 共 进 晚餐 。 
3-5 修改 嘉宾 名 单 : 你 刚 得 知 有 位 嘉宾 无 法 赴约 ， 因 此 需要 另外 邀请 一 位 嘉宾 。 
口 以 完成 练习 3-4 时 编写 的 程序 为 基础 ， 在 程序 末尾 添加 一 条 print 语句 ， 指 出 哪 


位 嘉宾 无 法 赴约 。 
口 修改 嘉宾 名 单 ， 将 无 法 赴约 的 嘉宾 的 姓名 替换 为 新 邀请 的 嘉宾 的 姓名 。 
口 再 次 打印 一 系列 消息 ， 向 名 单 中 的 每 位 嘉宾 发 出 邀请 。 
3-6 添加 嘉宾 : 你 刚 找到 了 一 个 更 大 的 餐桌 ， 可 容纳 更 多 的 嘉宾 。 请 想 想 你 还 想 邀 
请 哪 三 位 嘉宾 。 
口 以 完成 练习 3-4 或 练习 3-5 时 编写 的 程序 为 基础 ， 在 程序 末尾 添加 一 条 print 语 
各， 指出 你 找到 了 一 个 更 大 的 餐桌 。 
口 使 用 insert() 将 一 位 新 嘉宾 添加 到 名 单 开 头 。 
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口 使 用 insert() 将 另 一 位 新 嘉宾 添加 到 名 单 中 间 。 

口 使 用 append() 将 最 后 一 位 新 嘉宾 添加 到 名 单 末 尾 。 

口 打印 一 系列 消息 ， 向 名 单 中 的 每 位 嘉宾 发 出 邀请 。 

3-7 缩减 名 单 : 你 刚 得 知 新 购买 的 餐桌 无 法 及 时 送 达 ， 因 此 只 能 邀请 两 位 嘉宾 。 

口 以 完成 练习 3-6 时 编写 的 程序 为 基础 ， 在 程序 末尾 添加 一 行 代码 ， 打 印 一 条 你 只 

能 邀请 两 位 嘉宾 共 进 晚餐 的 消息 

口 使 用 pop() 不 断 地 删 及 ns 直到 只 有 两 位 嘉宾 为 止 。 每 次 从 名 单 中 弹 
出 一 位 嘉宾 时 ， 都 打印 一 条 消息 ， 让 该 嘉宾 知悉 你 很 抱歉 ， 无 法 邀请 他 来 共 进 
晚餐 。 

口 对 于 余下 的 两 位 嘉宾 中 的 每 一 位 ， 都 打印 一 条 消息 ， 指 出 他 依然 在 受 邀 人 之 列 。 

口 使 用 del 将 最 后 两 位 嘉宾 从 名 单 中 删除 ， 让 名 单 变 成 空 的 。 打 印 该 名 单 ， 核 实 程 
序 结 束 时 名 单 确实 是 空 的 。 


3.3 组 织 列 表 
在 你 创建 的 列表 中 , 元 素 的 排列 顺序 常常 是 无 法 预测 的 , 因为 你 并 非 总 能 控制 用 户 提供 数据 


的 顺序 。 这 虽然 在 大 多 数 情 况 下 都 是 不 可 避免 的 , 但 你 经 常 需要 以 特定 的 顺序 呈现 信息 。 有 时 候 ， 
你 希望 保留 列表 元 素 最 初 的 排列 顺序 ， 而 有 时 候 又 需要 调整 排列 顺序 。Python 提 供 了 很 多 组 织 列 
表 的 方式 ， 可 根据 具体 情况 选用 。 

3.3.1 使 用 方法 sort() 对 列表 进行 永久 性 排序 


Python 方 法 sort() 让 你 能 够 较为 轻松 地 对 列表 进行 排序 。 假 设 你 有 一 个 汽车 列表 ， 并 要 让 其 
中 的 汽车 按 字 母 顺序 排列 。 为 简化 这 项 任务 ， 我 们 假设 该 列表 中 的 所 有 值 都 是 小 写 的 。 


cars.py 


cars = ['bmw', 'audi', 'toyota', 'subaru'] 
@ cars.sort() 
print(cars) 
方法 sort()( 见 @ ) 永久 性 地 修改 了 列表 元 素 的 排列 顺序 。 现在, 汽车 是 按 字母 顺序 排列 的 ， 
再 也 无 法 恢复 到 原来 的 排列 顺序 : 


['audi', 'bmw', 'subaru', 'toyota'] 


你 还 可 以 按 与 字母 顺序 相反 的 顺序 排列 列表 元 素 ， 为 此 ， 只 需 向 sort() 方 法 传递 参数 
reverse=True。 下 面 的 示例 将 汽车 列表 按 与 字母 顺序 相反 的 顺序 排列 : 


cars = ['bmw', 'audi', 'toyota', 'subaru'|] 
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cars.sort(reverse=True) 
print(cars) 


同样 ， 对 列表 元 素 排列 顺序 的 修改 是 永久 性 的 : 


['toyota', 'subaru', 'bmw', 'audi'] 


3.3.2 ”使 用 函数 sorted() 对 列表 进行 临时 排序 


要 保留 列表 元 素 原 来 的 排列 顺序 ， 同 时 以 特定 的 顺序 呈现 它们 ， 可 使 用 函数 sorted()。 函 数 
sorted() 让 你 能 够 按 特 定 顺 序 显 示 列 表 元 素 ， 同 时 不 影响 它们 在 列表 中 的 原始 排列 顺序 。 
下 面 尝试 对 汽车 列表 调用 这 个 函数 。 


cars = ['bmw', 'audi', 'toyota', 'subaru'] 
@ print("Here is the original list:") 
print(cars) 


@ print("\nHere is the sorted list:") 
print(sorted(cars)) 


©@ print("\nHere is the original list again:") 
print(cars) 


我 们 首先 按 原 始 顺 序 打 印 列表 ( 见 @ )， 再 按 字 母 顺序 显示 该 列表 ( 见 @ )。 以 特定 顺序 显示 
列表 后 ， 我 们 进行 核实 ， 确 认 列 表 元 素 的 排列 顺序 与 以 前 相同 ( 见 @ )。 


Here is the original list: 
['bmw', 'audi', 'toyota', 'subaru'] 


Here is the sorted list: 
['audi', 'bmw', 'subaru', 'toyota'] 


@ Here is the original list again: 
['bmw', 'audi', 'toyota', 'subaru'] 


注意 ， 调 用 函数 sorted() 后 ， 列 表 元 素 的 排列 顺序 并 没有 变 ( 见 @ )。 如 果 你 要 按 与 字母 顺 
序 相反 的 顺序 显示 列表 ， 也 可 向 函数 sorted() 传 递 参数 reverse=True。 


注意 在 并 非 所 有 的 值 都 是 小 写 时 ， 按 字母 顺序 排列 列表 要 复杂 些 。 决 定 排列 顺序 时 ， 有 多 种 
解读 大 写字 母 的 方式 ， 要 指定 准确 的 排列 顺序 ， 可 能 比 我 们 这 里 所 做 的 要 复杂 。 然 而 ， 
大 多 数 排序 方式 都 基于 本 节 介 绍 的 知识 。 
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3.3.3 倒 着 打印 列表 


要 反 转 列表 元 素 的 排列 顺序 ， 可 使 用 方法 reverse()。 假 设 汽车 列表 是 按 购买 时 间 排 列 的 ， 
可 轻松 地 按 相 反 的 顺序 排列 其 中 的 汽车 : 


Cars ['bmw' , "audi"', 
print(cars) 


'toyota', 'subaru'] 
cars.reverse() 
print(cars) 


注意 ，reverse() 不 是 指 按 与 字母 顺序 相反 的 顺序 排列 列表 元 素 ， 而 只 是 反 转 列表 元 素 的 排 
列 顺序 : 


['bmw', ‘audi', 'toyota', 'subaru'] 
['subaru', 'toyota', 'audi', 'bmw'] 


方法 reverse() 永 久 性 地 修改 列表 元 素 的 排列 顺序 ， 但 可 随时 恢复 到 原来 的 排列 顺序 ， 为 此 
只 需 对 列表 再 次 调用 reverse() 即 可 。 


3.3.4 ”确定 列表 的 长 度 
使 用 函数 len() 可 快速 获悉 列表 的 长 度 。 在 下 面 的 示例 中 , 列表 包含 4 个 元 素 , 因此 其 长 度 为 4: 


>>> cars = ['bmw', 'audi', 'toyota', 'subaru'] 
>>> len(cars) 
4 


在 你 需要 完成 如 下 任务 时 ，len() 很 有 用 : 确定 还 有 多 少 个 外 星人 未 被 射 杀 ,需要 管理 多 少 
项 可 视 化 数据 ， 网 站 有 多 少 注册 用 户 等 。 


注意 ”Python 计算 列表 元 素数 时 从 1 开始 ， 因 此 确定 列表 长 度 时 ， 你 应 该 不 会 遇 到 差 一 错误 。 


动手 试 一 斌 


3-8 放眼 世界 : 想 出 至 少 $ 个 你 渴望 去 旅游 的 地 方 。 

口 将 这 些 地 方 存储 在 一 个 列表 中 ， 并 确保 其 中 的 元 素 不 是 按 字母 顺序 排列 的 。 

口 按 原 始 排列 顺序 打印 该 列表 。 不 要 考虑 输出 是 否 整 洁 的 问题 ， 只 管 打 印 原 始 
Python 列表 。 

口 使 用 sorted() 按 字母 顺序 打印 这 个 列表 ， 同 时 不 要 修改 它 。 

口 再 次 打印 该 列表 ， 核 实 排列 顺序 未 变 。 

口 使 用 sorted() 按 与 字母 顺序 相反 的 顺序 打印 这 个 列表 ， 同 时 不 要 修改 它 。 
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口 再 次 打印 该 列表 ， 核 实 排列 顺序 未 变 。 
口 使 用 reverse() 修 改 列表 元 素 的 排列 顺序 。 打印 该 列表 , 核实 排列 顺序 确实 变 了 。 
口 使 用 feverse() 再 次 修改 列表 元 素 的 排列 顺序 。 打 印 该 列表 ， 核 实 已 恢复 到 原来 


的 排列 顺序 。 
口 使 用 sort() 修 改 该 列表 ， 使 其 元 素 按 字母 顺序 排列 。 打 印 该 列表 ， 核 实 排 列 顺 
序 确实 变 了 。 


口 使 用 sort() 修 改 该 列表 ， 使 其 元 素 按 与 字母 顺序 相反 的 顺序 排列 。 打 印 该 列表 ， 
核实 排列 顺序 确实 变 了 。 
3-9 晚餐 嘉宾 : 在 完成 练习 3-4~ 练 习 3-7 时 编写 的 程序 之 一 中 ,使 用 len() 打 印 一 
条 消息 ， 指 出 你 邀请 了 多 少 位 嘉宾 来 与 你 共 进 晚餐 。 
3-10 尝试 使 用 各 个 函数 : 想 想 可 存储 到 列表 中 的 东西 ， 如 山 捆 、 河 流 、 国 家 、 城 
市 、 语 言 或 你 喜欢 的 任何 东西 。 编 写 一 个 程序 ， 在 其 中 创建 一 个 包含 这 些 元 素 的 列表 ， 
然后 ， 对 于 本 章 介 绍 的 每 个 函数 ， 都 至 少 使 用 一 次 来 处 理 这 个 列表 。 


3.4 使 用 列表 时 避免 索引 错误 
刚 开始 使 用 列表 时 ,经 常会 遇 到 一 种 错误 。 假 设 你 有 一 个 包含 三 个 元 素 的 列表 , 却 要 求 获取 
第 四 个 元 素 : 


motorcycles = ['honda', 'yamaha', 'suzuki'] 
print(motorcycles[3]) 


这 将 导致 索引 错误 : 


Traceback (most recent call last): 
File "motorcycles.py", line 3, in <module> 
print(motorcycles[3]) 
IndexError: list index out of range 
Python 试图 向 你 提供 位 于 索引 3 处 的 元 素 , 但 它 搜索 列表 motorcycles 时 , 却 发 现 索引 3 处 没有 
元 素 。 鉴 于 列表 索引 差 一 的 特征 ， 这 种 错误 很 常见 。 有 些 人 从 1 开始 数 ， 因 此 以 为 第 三 个 元 素 的 
索引 为 3; 但 在 Python 中 ， 第 三 个 元 素 的 索引 为 2， 因 为 索引 是 从 0 开始 的 。 
索引 错误 意味 着 Python 无 法 理解 你 指定 的 索引 。 程 序 发 生 索 引 错 误 时 ， 请 尝试 将 你 指定 的 索 
引 减 1， 然 后 再 次 运行 程序 ， 看 看 结果 是 否 正确 。 
别 忘 了 , 每 当 需 要 访问 最 后 一 个 列表 元 素 时 , 都 可 使 用 索引 -1。 这 在 任何 情况 下 都 行 之 有 效 ， 
即便 你 最 后 一 次 访问 列表 后 ， 其 长 度 发 生 了 变化 : 


motorcycles 'honda', 'yamaha', Suzuki |] 


print(motorcycles[-1]) 
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索引 -1 总 是 返回 最 后 一 个 列表 元 素 ， 这 里 为 值 'suzuki ' : 


"SUZuKi 


仅 当 列表 为 空 时 ， 这 种 访问 最 后 一 个 元 素 的 方式 才 会 导致 错误 : 


motorcycles = [] 
print(motorcycles[-1]) 


列表 motorcycles 不 包含 任何 元 素 ， 因 此 Python 返回 一 条 索引 错误 消息 : 


Traceback (most recent call last): 
File "motorcyles.py", line 3, in <module> 
print(motorcycles[-1]) 
IndexError: list index out of range 


注意 发 生 索 引 错 误 却 找 不 到 解决 办 法 时 ， 请 尝试 将 列表 或 其 长 度 打印 出 来 。 列 表 可 能 与 你 以 
为 的 截然 不 同 ， 在 程序 对 其 进行 了 动态 处 理 时 尤其 如 此 。 通 过 查看 列表 或 其 包含 的 元 素 8 
数 ， 可 帮助 你 找 出 这 种 逻辑 错误 。 


动手 试 一 斌 
3-11 有 意 引 发 错误 : 如 果 你 还 没有 在 程序 中 遇 到 过 索引 错误 , 就 尝试 引发 一 个 这 种 


错误 。 在 你 的 一 个 程序 中 ,修改 其 中 的 索引 ,以 引发 索引 错误 。 关 闭 程 序 前 , 务必 消除 


这 个 错误 。 


3.5 ”小结 


在 本 章 中 , 你 学 习 了 : 列表 是 什么 以 及 如 何 使 用 其 中 的 元 素 ; 如 何 定义 列表 以 及 如 何 增 删 元 
素 ; 如 何 对 列表 进行 永久 性 排序 ， 以 及 如 何 为 展示 列表 而 进行 临时 排序 ;如 何 确定 列表 的 长 度 
以 及 在 使 用 列表 时 如 何 避 免 索引 错误 。 

在 第 4 章 ， 你 将 学 习 如 何以 更 高 效 的 方式 处 理 列 表 元 素 。 通 过 使 用 为 数 不 多 的 几 行 代码 来 遍 
历 列表 元 素 ， 你 就 能 高 效 地 处 理 它 们 ， 即 便 列 表 包 含 数 千 乃至 数 百 万 个 元 素 。 


河 


操作 列表 


在 第 3 章 , 你 学 习 了 如 何 创建 简单 的 列表 , 还 学 习 了 如 何 操作 列 
表 元 素 。 在 本 章 中 ， 你 将 学 习 如 何 遍 历 整 个 列表 ， 这 只 需要 几 行 代 
码 ， 无 论 列 表 有 多 长 。 循 环 让 你 能 够 对 列表 的 每 个 元 素 都 采取 一 个 
或 一 系列 相同 的 措施 ， 从 而 高 效 地 处 理 任 何 长 度 的 列表 ， 包 括 包含 
数 千 乃至 数 百 万 个 元 素 的 列表 。 


4.1 遍历 整个 列表 


你 经 党 需要 遍历 列表 的 所 有 元 素 ， 对 每 个 元 素 执 行 相同 的 操作 。 例 如， 在 游戏 中 ,可 能 需要 
将 每 个 界面 元 素平 移 相 同 的 距离 ; 对 于 包含 数字 的 列表 , 可 能 需要 对 每 个 元 素 执 行 相同 的 统计 运 
算 ; 在 网 站 中 ,可 能 需要 显示 文章 列表 中 的 每 个 标题 。 需 要 对 列表 中 的 每 个 元 素 都 执行 相同 的 操 
作 时 ， 可 使 用 Python 中 的 for 循 环 。 

假设 我 们 有 一 个 魔术 师 名 单 ， 需要 将 其 中 每 个 魔术 师 的 名 字 都 打印 出 来 。 为 此 , 我 们 可 以 分 
别 获取 名 单 中 的 每 个 名 字 , 但 这 种 做 法 会 导致 多 个 问题 。 例 如 ， 如 果 名 单 很 长 , 将 包含 大 量 重复 
的 代码 。 另 外 ， 每 当 名 单 的 长 度 发 生变 化 时 ， 都 必须 修改 代码 。 通 过 使 用 for 循 环 ， 可 让 Python 
去 处 理 这 些 问 题 。 

下 面 使 用 for 循 环 来 打印 魔术 师 名 单 中 的 所 有 名 字 : 


magicians.py 


@ magicians = ['alice', 'david', 'carolina'] 
@ for magician in magicians: 
(3 print(magician) 


首先 , 我 们 像 第 3 童 那 样 定义 了 一 个 列表 ( 见 @ )。 接 下 来 ,我 们 定义 了 一 个 for 循 环 ( 见 @ ); 
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这 行 代码 让 Python 从 列表 magicians 中 取出 一 个 名 字 ,， 并 将 其 存储 在 变量 magician 中 。 最 后 ,我 们 
让 Python 打印 前 面 存储 到 变量 magician 中 的 名 字 ( 见 @ )。 这 样 ， 对 于 列表 中 的 每 个 名 字 ，Python 
都 将 重复 执行 @ 处 和 @ 处 的 代码 行 。 你 可 以 这 样 解读 这 些 代 码 : 对 于 列表 magicians 中 的 每 位 魔术 
师 ， 都 将 其 名 字 打 印 出 来 。 输 出 很 简单 ， 就 是 列表 中 所 有 的 姓名 : 


alice 
david 
carolina 


4.1.1 深入 地 研究 循环 


循环 这 种 概念 很 重要 ， 因 为 它 是 让 计算 机 自动 完成 重复 工作 的 常见 方式 之 一 。 例 如 , 在 前 面 
的 magicians.py 中 使 用 的 简单 循环 中 ，Python 将 首先 读 取 其 中 的 第 一 行 代码 : 


for magician in magicians: 


这 行 代码 让 Python 获取 列表 magicians 中 的 第 一 个 值 ( "alice' )， 并 将 其 存储 到 变量 magician 
中 。 接 下 来 ，Python 读 取 下 一 行 代 码 ; 


print(magician) 


它 让 Python 打印 magician 的 值 一 一 依然 是 'alice' 。 鉴 于 该 列表 还 包含 其 他 值 ，Python 返 回 到 
循环 的 第 一 行 : 


for magician in magicians: 


Python 获取 列表 中 的 下 一 个 名 字 一 一 'david' ,并 将 其 存储 到 变量 magician 中 ,再 执行 下 面 这 
行 代码 : 


print(magician) 


Python 青 次 打印 变量 magician 的 值 一 一 当前 为 'david'。 接 下 来 ，Python 青 次 执行 整个 循环 ， 
对 列表 中 的 最 后 一 个 值 一 一 ' carolina' 进 行 处 理 。 至 此 ， 列 表 中 没有 其 他 的 值 了 ， 因 此 Python 接 
着 执行 程序 的 下 一 行 代码 。 在 这 个 示例 中 ，for 循 环 后 面 没 有 其 他 的 代码 ， 因 此 程序 就 此 结束 。 

刚 开 始 使 用 循环 时 请 牢记 , 对 列表 中 的 每 个 元 素 ， 都 将 执行 循环 指定 的 步骤 ,而 不 管 列 表 包 
含 多 少 个 元 素 。 如 果 列 表 包 含 一 百 万 个 元 素 ，Python 就 重复 执行 指定 的 步 又 一 百 万 次 ， 且 通常 速 
度 非常 快 。 

另外 ， 编 写 for 循 环 时 ， 对 于 用 于 存储 列表 中 每 个 值 的 临时 变量 ， 可 指定 任何 名 称 。 然 而 ， 
选择 描述 单个 列表 元 素 的 有 意义 的 名 称 大 有 帮助 。 例 如 , 对 于 小 猫 列 表 、 小 狗 列 表 和 一 般 性 列表 ， 
像 下 面 这 样 编写 for 循 环 的 第 一 行 代码 是 不 错 的 选择 : 
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for cat in cats: 
for dog in dogs: 
for item in list of items: 


这 些 命 名 约定 有 助 于 你 明白 for 循 环 中 将 对 每 个 元 素 执 行 的 操作 。 使 用 单数 和 复数 式 名 称 ， 
可 帮助 你 判断 代码 段 处 理 的 是 单个 列表 元 素 还 是 整个 列表 。 


4.1.2 ”在 for 循环 中 执行 更 多 的 操作 


在 for 循 环 中 ， 可 对 每 个 元 素 执行 任何 操作 。 下 面 来 扩展 前 面 的 示例 ， 对 于 每 位 魔术 师 ， 都 
打印 一 条 消息 ， 指 出 他 的 表演 大 精彩 了 。 


magicians ['alice', 'david', 
for magician in magicians: 
© print(magician.title() + ", that was a great trick!") 


'carolina'] 


相 比 于 前 一 个 示例 ,唯一 的 不 同 是 对 于 每 位 魔术 师 , 都 打印 了 一 条 以 其 名 字 为 抬头 的 消息 ( 见 
@ )。 这 个 循环 第 一 次 迭代 时 ， 变 量 magician 的 值 为 'alice' ， 因 此 Python 打印 的 第 一 条 消息 的 抬 
头 为 'Alice'。 第 二 次 迭代 时 ， 消 息 的 抬头 为 'David' ， 而 第 三 次 迭代 时 ， 抬 头 为 'Carolina'。 
下 面 的 输出 表明 ， 对 于 列表 中 的 每 位 魔术 师 ， 都 打印 了 一 条 个 性 化 消息 : 


Alice, that was a great trick! 
David, that was a great trick! 
Carolina, that was a great trick! 


在 for 循 环 中 ， 想 包含 多 少 行 代码 都 可 以 。 在 代码 行 for magician in magicians 后 面 ， 每 个 
缩 进 的 代码 行 都 是 循环 的 一 部 分 ， 且 将 针对 列表 中 的 每 个 值 都 执行 一 次 。 因 此 ， 可 对 列表 中 的 每 
个 值 执行 任意 次 数 的 操作 。 

下 面 再 添加 一 行 代码 ， 告 诉 每 位 魔术 师 ， 我 们 期 待 他 的 下 一 次 表演 : 


magicians = ['alice', 'david', 'carolina'| 
for magician in magicians: 
print(magician.title() + ", that was a great trick!") 
© print("I can't wait to see your next trick, " + magician.title() + ".\n") 


由 于 两 条 print 语 句 都 缩 进 了 ， 因 此 它们 都 将 针对 列表 中 的 每 位 魔术 师 执 行 一 次 。 第 二 条 
print 请 句 中 的 换行 符 "\n" ( 见 @ ) 在 每 次 迭代 结束 后 都 插入 一 个 空 行 , 从 而 整洁 地 将 针对 各 位 魔 
术 师 的 消息 编组 : 


Alice, that was a great trick! 
I can't wait to see your next trick, Alice. 


David, that was a great trick! 
I can't wait to see your next trick, David. 
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Carolina, that was a great tTickl 
I can't wait to see your next trick, Carolina. 


在 for 循 环 中 ， 想 包含 多 少 行 代码 都 可 以 。 实 际 上 ， 你 会 发 现 使 用 for 循 环 对 每 个 元 素 执行 众 
多 不 同 的 操作 很 有 用 。 


4.1.3 在 for 循环 结束 后 执行 一 些 操作 


for 循 环 结束 后 再 怎么 做 呢 ? 通常 , 你 需要 提供 总 结 性 输出 或 接着 执行 程序 必须 完成 的 其 他 
任务 。 

在 for 循 环 后 面 ， 没 有 缩 进 的 代码 都 只 执行 一 次 ， 而 不 会 重复 执行 。 下 面 来 打印 一 条 向 全 体 
魔术 师 致 谢 的 消息 , 感谢 他 们 的 精彩 表演 。 想 要 在 打印 给 各 位 魔术 师 的 消息 后 面 打印 一 条 给 全 体 
魔术 师 的 致谢 消息 ， 需 要 将 相应 的 代码 放 在 for 循 环 后 面 ， 且 不 缩 进 : 


magicians = ['alice', 'david', 'carolina'] 
for magician in magicians: 
print(magician.title() + ", that was a great trick!") 
print("I can't wait to see your next trick, " + magician.title() + ".\n") 


@ print("Thank you, everyone. That was a great magic show!") 


你 在 前 面 看 到 了 ， 开 头 两 条 print 语 句 针 对 列表 中 每 位 魔术 师 重 复 执行 。 然 而 ， 由 于 第 三 条 
print 语 句 没 有 缩 进 ， 因 此 只 执行 一 次 : 


Alice, that was a great trick! 
can't wait to see your next trick, Alice. 


David, that was a great trick! 
can't wait to see your next trick, David. 


Carolina, that was a great trick! 
can't wait to see your next trick, Carolina. 


Thank you, everyone. That was a great magic show! 


使 用 for 循 环 处 理 数 据 是 一 种 对 数据 集 执行 整体 操作 的 不 错 的 方式 。 例如 ,你 可 能 使 用 for 循 
环 来 初始 化 游戏 一 一 遍历 角色 列表 , 将 每 个 角色 都 显示 到 屏幕 上 ; 再 在 循环 后 面 添加 一 个 不 缩 进 
的 代码 块 ， 在 屏幕 上 绘制 所 有 角色 后 显示 一 个 Play Now 按 钮 。 


4.2 ”避免 缩 进 错误 


Python 根据 缩 进 来 判断 代码 行 与 前 一 个 代码 行 的 关系 。 在 前 面 的 示例 中 ,向 各 位 魔术 师 显 示 
消息 的 代码 行 是 for 循 环 的 一 部 分 ， 因 为 它们 缩 进 了 。Python 通 过 使 用 缩 进 让 代码 更 易 读 ; 简单 
地 说 ， 它 要 求 你 使 用 缩 进 让 代码 整洁 而 结构 清晰 。 在 较 长 的 Python 程序 中 ， 你 将 看 到 缩 进 程度 各 
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不 相同 的 代码 块 ， 这 让 你 对 程序 的 组 织 结构 有 大 致 的 认识 。 

当 你 开始 编写 必须 正确 缩 进 的 代码 时 ， 需 要 注意 一 些 常见 的 缩 进 错误 。 例 如 ， 有 时 候 ， 程 序 
员 会 将 不 需要 缩 进 的 代码 块 缩 进 , 而 对 于 必须 缩 进 的 代码 块 却 忘 了 缩 进 。 通过 查看 这 样 的 错误 示 
例 ， 有 助 于 你 以 后 避 开 它们 ， 以 及 在 它们 出 现在 程序 中 时 进行 修复 。 

下 面 来 看 一 些 较为 常见 的 缩 进 错误 。 


4.2.1 忘记 缩 进 
对 于 位 于 for 语 句 后 面 且 属于 循环 组 成 部 分 的 代码 行 , 一 定 要 缩 进 。 如 果 你 忘记 缩 进 , Python 


会 提醒 你 : 


magicians.py 


magicians = ['alice', 'david', 'carolina'] 
for magician in magicians: 
@ print(magician) 


print 语 句 ( 见 @ ) 应 缩 进 却 没 有 缩 进 。Python 没 有 找到 期 望 缩 进 的 代码 块 时 , 会 让 你 知道 哪 
行 代码 有 问题 。 


File "magicians.py", line 3 
print(magician) 
人 


IndentationError: expected an indented block 


通常 ， 将 紧 跟 在 for 语 句 后 面 的 代码 行 缩 进 ， 可 消除 这 种 缩 进 错误 。 
4.2.2 ”忘记 缩 进 额外 的 代码 行 

有 时 候 , 循环 能 够 运行 而 不 会 报告 错误 , 但 结果 可 能 会 出 平 意 料 。 试图 在 循环 中 执行 多 项 任 
务 ， 却 忘记 缩 进 其 中 的 一 些 代 码 行 时 ， 就 会 出 现 这 种 情况 。 


例如 ， 如 果 忘 记 缩 进 循环 中 的 第 2 行 代码 〈 它 告诉 每 位 魔术 师 ， 我 们 期 待 他 的 下 一 次 表演 )， 
就 会 出 现 这 种 情况 : 


magicians = ['alice'’, 'david', 'carolina'] 
for magician in magicians: 
print(magician.title() + ", that was a great trick!") 
@ print("I can't wait to see your next trick, " + magician.title() + ".\n") 


第 二 条 print 语 句 ( 见 @ ) 原本 需要 缩 进 ， 但 Python 发 现 for 语 句 后 面 有 一 行 代码 是 缩 进 的 ， 
因此 它 没有 报告 错误 。 最 终 的 结果 是 ， 对 于 列表 中 的 每 位 魔术 师 ， 都 执行 了 第 一 条 print 语 句 ， 
因为 它 缩 进 了 ; 而 第 二 条 print 语 句 没 有 缩 进 ， 因 此 它 只 在 循环 结束 后 执行 一 次 。 由 于 变量 
magician 的 终 值 为 'carolina' ， 因 此 只 有 她 收 到 了 消息 “looking forward to the next trick”: 
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Alice, that was a great trick! 

David, that was a great trick! 

Carolina, that was a great trick! 

I can't wait to see your next trick, Carolina. 


这 是 一 个 逻辑 错误 。 从 语法 上 看 ， 这 些 Python 代 码 是 合法 的 , 但 由 于 存在 逻辑 错误 ,结果 并 
不 符合 预期 。 如 果 你 预期 某 项 操作 将 针对 每 个 列表 元 素 都 执行 一 次 , 但 它 却 只 执行 了 一 次 , 请 确 
定 是 否 需要 将 一 行 或 多 行 代码 缩 进 。 


4.2.3 不 必要 的 缩 进 


如 果 你 不 小 心 缩 进 了 无 需 缩 进 的 代码 行 ，Python 将 指出 这 一 点 : 


hello_world.py 


message = "Hello Python world!" 
© print(message) 


print 语 句 ( 见 @ ) 无 需 缩 进 ， 因 为 它 并 不 属于 前 一 行 代码 ， 因 此 Python 将 指出 这 种 错误 : 


File "hello world.py", line 2 
print(message) 


IndentationError: unexpected indent 


为 避免 意外 缩 进 错误 ， 请 只 缩 进 需要 缩 进 的 代码 。 在 前 面 编写 的 程序 中 ， 只 有 要 在 for 循 环 
中 对 每 个 元 素 执行 的 代码 需要 缩 进 。 


4.2.4 循环 后 不 必要 的 缩 进 


如 果 你 不 小 心 缩 进 了 应 在 循环 结束 后 执行 的 代码 ， 这 些 代 码 将 针对 每 个 列表 元 素 重 复 执行 。 
在 有 些 情况 下 ， 这 可 能 导致 Python 报 告 语法 错误 ,但 在 大 多 数 情况 下 ， 这 只 会 导致 逻辑 错误 。 

例如 ， 如 果 不 小 心 缩 进 了 感谢 全 体 魔术 师 精 彩 表演 的 代码 行 ， 结 果 将 如 何 呢 ? 

magicians = ["alice'， 'david', 'carolina'] 

for magician in magicians: 


print(magician.title() + ", that was a great trick!") 
print("I can't wait to see your next trick, " + magician.title() + ".\n") 


@ print("Thank you everyone, that was a great magic show!") 


由 于 @ 处 的 代码 行 被 缩 进 ， 它 将 针对 列表 中 的 每 位 魔术 师 执行 一 次 ， 如 @ 所 示 : 


Alice, that was a great trick! 
I can't wait to see your next trick, Alice. 


@ Thank you everyone, that was a great magic show! 
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David, that was a great trick! 
I can't wait to see your next trick, David. 


@ Thank you everyone, that was a great magic show! 
Carolina, that was a great trick! 


I can't wait to see your next trick, Carolina. 


@ Thank you everyone, that was a great magic Showl 


这 也 是 一 个 逻辑 错误 ， 与 4.2.2 节 的 错误 类 似 。Python 不 知道 你 的 本 意 ， 只 要 代码 符合 语法 ， 


已 就 会 运行 。 如 果 原 本 只 应 执行 一 次 的 操作 执行 了 多 次 , 请 确定 你 是 否 不 应 该 缩 进 执行 该 操作 
代码 。 


4.2.5 遗漏 了 冒号 


for 语 句 末尾 的 冒号 告诉 Python ， 下 一 行 是 循环 的 第 一 行 。 


的 


magicians = ["alice'， 'david', 'carolina'] 
@ for magician in magicians 
print (magician) 


如 果 你 不 小 心 遗漏 了 冒号 ， 如 上 @ 所 示 ， 将 导致 语法 错误 ， 因 为 Python 不 知道 你 意欲 何 为 。 
种 错误 虽然 易于 消除 , 但 并 不 那么 容易 发 现 。 程序 员 为 找 出 这 样 的 单字 符 错误 ,花费 的 时 间 多 
令 人 惊讶 。 这 样 的 错误 之 所 以 难以 发 现 ， 是 因为 通常 在 我 们 的 意料 之 外 。 


动手 试 一 斌 
4-1 比萨 : 想 出 至 少 三 种 你 喜欢 的 比萨 将 其 名 称 存储 在 一 个 列表 中 ， 再 使 用 for 
循环 将 每 种 比萨 的 名 称 都 打印 出 来 。 
口 修改 这 个 for 循环 ， 使 其 打印 包含 比萨 名 称 的 句子 ， 而 不 仅仅 是 比萨 的 名 称 。 对 
于 每 种 比萨 ， 都 显示 一 行 输出 ， 如 “Ilike pepperoni pizza”。 
口 在 程序 末尾 添加 一 行 代码 ， 它 不 在 for 循环 中 ， 指 出 你 有 多 喜欢 比萨 。 输 出 应 包 


含 针 对 每 种 比萨 的 消息 ， 还 有 一 个 总 结 性 句子 ， 如 “I really love pizza!”。 
4-2 动物 : 想 出 至 少 三 种 有 共同 特征 的 动物 , 将 这 些 动 物 的 名 称 存储 在 一 个 列表 中 ， 
再 使 用 for 循环 将 每 种 动物 的 名 称 都 打印 出 来 。 
口 修改 这 个 程序 , 使 其 针对 每 种 动物 都 打印 一 个 句子 , 如 “A dog would make a great 
pet” 。 
口 在 程序 末尾 添加 一 行 代码 ， 指 出 这 些 动物 的 共同 之 处 ， 如 打印 诸如 “Any ofthese 
animals would make a great pet!” 这 样 的 句子 。 


这 
得 


4.3 创建 数值 列表 51 


4.3 创建 数值 列表 


需要 存储 一 组 数字 的 原因 有 很 多 ， 例 如 ,在 游戏 中 , 需要 跟踪 每 个 角色 的 位 置 ， 还 可 能 需要 
跟踪 玩家 的 几 个 最 高 得 分 。 在 数据 可 视 化 中 , 处 理 的 几乎 都 是 由 数字 ( 如 温度 、 距离 、 人 口 数量 、 
经 度 和 纬度 等 ) 组 成 的 集合 。 

列表 非常 适合 用 于 存储 数字 集合 , 而 Python 提供 了 很 多 工具 , 可 帮助 你 高 效 地 处 理 数字 列表 。 
明白 如 何 有 效 地 使 用 这 些 工 具 后 ， 即 便 列表 包含 数 百 万 个 元 素 ， 你 编写 的 代码 也 能 运行 得 很 了 。 四 中 首 


4.3.1 使 用 函数 range() 


Python 函数 range() 让 你 能 够 轻松 地 生成 一 系列 的 数字 。 例 如 ， 可 以 像 下 面 这 样 使 用 函数 
range() 来 打印 一 系列 的 数字 : 


numbers.py 


for value in range(1,5): 
print(value) 


上 述 代 码 好 像 应 该 打印 数字 1~5， 但 实际 上 它 不 会 打印 数字 5: 


入 DP 


在 这 个 示例 中 , range() 只 是 打印 数字 1~4, 这 是 你 在 编程 语言 中 经 常 看 到 的 差 一 行为 的 结 
函数 range() 让 Python 从 你 指定 的 第 一 个 值 开始 数 , 并 在 到 达 你 指定 的 第 二 个 值 后 停止 , 因此 输出 
不 包含 第 二 个 值 ( 这 里 为 5 )。 

要 打印 数字 1~5， 需 要 使 用 range(1,6): 


for value in range(1,6): 
print(value) 


这 样 ， 输 出 将 从 1 开始 ， 到 5 结 


MPODODP 


使 用 range() 时 ， 如 果 输 出 不 符合 预期 ， 请 尝试 将 指定 的 值 加 1 或 减 1。 
4.3.2 ”使 用 range() 创 建 数字 列表 
要 创建 数字 列表 ， 可 使 用 函数 list() 将 range() 的 结果 直接 转换 为 列表 。 如 果 将 range() 作 为 
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list() 的 参数 ， 输 出 将 为 一 个 数字 列表 。 
在 前 一 节 的 示例 中 , 我 们 打印 了 一 系列 数字 。 要 将 这 些 数字 转换 为 一 个 列表 , 可 使 用 list(): 


numbers = list(range(1,6)) 
print(numbers) 


结果 如 下 : 


[1，2，3，4，5] 


使 用 函数 range() 时 ， 还 可 指定 步 长 。 例 如 ， 下 面 的 代码 打印 1~10 内 的 偶数 : 


even_numbers.py 


even numbers = list(range(2,11,2)) 
print(even numbers) 


在 这 个 示例 中 ， 函 数 range() 从 2 开始 数 ， 然 后 不 断 地 加 2， 直 到 达到 或 超过 终 值 ( 11 )， 因 此 
输出 如 下 : 


[2, 4, 6, 8, 10] 


使 用 函数 range() 几 乎 能 够 创建 任何 需要 的 数字 集 ， 例 如 ， 如 何 创 建 一 个 列表 ， 其 中 包含 前 
10 个 整数 ( 即 1~10 ) 的 平方 呢 ? 在 Python 中 ， 两 个 星 号 (** ) 表示 乘 方 运算 。 下 面 的 代码 演示 了 
如 何 将 前 10 个 整数 的 平方 加 入 到 一 个 列表 中 : 


squares.py 


@ squares = [| 

@ for value in range(1,11): 
3 square = value**2 

@ squares.append(square) 


© print(squares) 


首先 , 我 们 创建 了 一 个 空 列表 ( 见 @ ); 接 下 来 , 使 用 函数 range() 让 Python 遍历 1~10 的 值 ( 见 
@ ),。 在 循环 中 ,计算 当前 值 的 平方 ， 并 将 结果 存储 到 变量 square 中 ( 见 @ )。 然 后 ， 将 新 计算 得 
到 的 平方 值 附 加 到 列表 squares 末 尾 ( 见 @ )。 最 后 ， 循 环 结束 后 ， 打 印 列 表 squares ( 见 @ ): 


[1, 4, 9, 16, 25, 36, 49, 64, 81, 100] 


为 让 这 些 代 码 更 简洁 ， 可 不 使 用 临时 变量 square， 而 直接 将 每 个 计算 得 到 的 值 附加 到 列表 
末尾 : 


squares [ 
for Value in range(1,11): 
© squares.append(value**2) 
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print(squares) 


@ 处 的 代码 与 Squares.py 中 @ 处 和 @ 处 的 代码 等 效 。 在 循环 中 ,计算 每 个 值 的 平方 ， 并 立即 将 
结果 附加 到 列表 squares 的 末尾 。 

创建 更 复杂 的 列表 时 ， 可 使 用 上 述 两 种 方法 中 的 任何 一 种 。 有 时 候 , 使 用 临时 变量 会 让 代码 
更 易 读 ; 而 在 其 他 情况 下 ， 这样 做 只 会 让 代码 无 谓 地 变 长。 你 首先 应 该 考虑 的 是 ,编写 清晰 易 懂 i 
且 能 完成 所 需 功能 的 代码 ; 等 到 审核 代码 时 ， 再 考虑 采用 更 高 效 的 方法 。 


4.3.3 ”对 数字 列表 执行 简单 的 统计 计算 


有 了 几 个 专门 用 于 处 理 数字 列表 的 Python 函数 。 例 如 ， 你 可 以 轻松 地 找 出 数字 列表 的 最 大 值 、 
最 小 值 和 总 和 : 


>>> digits = [1， 2，3，4，5， 6， 7， 8， 9， 0] 
>>> min(digits) 


0 
>>> max(digits) 


>>> sum(digits) 
45 


注意 ”出 于 版 面 考 虑 ， 本 节 使 用 的 数字 列表 都 很 短 ， 但 这 里 介绍 的 知识 也 适用 于 包含 数 百 万 个 
数字 的 列表 。 


4.3.4 列表 解析 


前 面 介绍 的 生成 列表 squares 的 方式 包含 三 四 行 代码 ， 而 列表 解析 让 你 只 需 编写 一 行 代码 就 
能 生成 这 样 的 列表 。 列 表 解 析 将 for 循 环 和 创建 新 元 素 的 代码 合并 成 一 行 ， 并 自动 附加 新 元 素 。 
向 初学 者 的 书籍 并 非 都 会 介绍 列表 解析 , 这 里 之 所 以 介绍 列表 解析 , 是 因为 等 你 开始 阅读 他 人 
写 的 代码 时 ， 很 可 能 会 遇 到 它们 。 
下 面 的 示例 使 用 列表 解析 创建 你 在 前 面 看 到 的 平方 数列 表 : 


squares.py 


讨 马 


squares = [value**2 for value in range(1,11)] 
print(squares) 


要 使 用 这 种 语法 ， 首 先 指定 一 个 描述 性 的 列表 名 ， 如 squares; 然后 ， 指 定 一 个 左 方 括号 ， 
并 定义 一 个 表达 式 ， 用 于 生成 你 要 存储 到 列表 中 的 值 。 在 这 个 示例 中 ， 表 达 式 为 valuex*2， 它 计 
算 平 方 值 。 接 下 来 ， 编 写 一 个 for 循 环 , 用 于 给 表达 式 提 供 值 ， 再 加 上 右 方 括号 。 在 这 个 示例 中 ， 
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for 循 环 为 for value in range(1,11)， 它 将 值 1~10 提 供给 表达 式 value*+*2。 请 注意 ， 这 里 的 for 
语句 末尾 没有 冒号 。 
结果 与 你 在 前 面 看 到 的 平方 数列 表 相 同 : 


[1, 4, 9, 16, 25, 36, 49, 64, 81, 100] 


要 创建 自己 的 列表 解析 , 需要 经 过 一 定 的 练习 , 但 能 够 熟练 地 创建 常规 列表 后 ,你 会 发 现 这 
样 做 是 完全 值得 的 。 当 你 觉得 编写 三 四 行 代码 来 生成 列表 有 点 繁复 时 , 就 应 考虑 创建 列表 解析 了 。 


动手 试 一 试 

4-3 数 到 20: 使 用 一 个 for 循环 打印 数字 1~20 ( 含 )。 

4-4 一 百 万 : 创建 一 个 列表 ， 其 中 包含 数字 1~1 000 000， 再 使 用 一 个 for 循环 将 这 
些 数字 打印 出 来 (如 果 输 出 的 时 间 太 长 ， 按 Ctrl+C 停 止 输出 ， 或 关闭 输出 窗口 )。 

4-5 计算 1~1 000 000 的 总 和 : 创建 一 个 列表 ， 其 中 包含 数字 1~1 000 000， 再 使 用 
min() 和 max() 核 实 该 列表 确实 是 从 1 开始， 到 1 000 000 结束 的 。 另 外 ， 对 这 个 列表 调 
用 函数 sum()， 看 看 Python 将 一 百 万 个 数字 相 加 需要 多 长 时 间 。 

4-6 奇数 : 通过 给 函数 Tange() 指 定 第 三 个 参数 来 创建 一 个 列表 ， 其 中 包含 1~20 的 
奇数 ; 再 使 用 一 个 for 循环 将 这 些 数字 都 打印 出 来 。 

4-73 的 倍数 : 创建 一 个 列表 , 其 中 包含 3~30 内 能 被 3 整除 的 数字 ; 再 使 用 一 个 for 
循环 将 这 个 列表 中 的 数字 都 打印 出 来 。 

4-8 立方 : 将 同一 个 数字 乘 三 次 称 为 立方 。 例 如 ， 在 Python 中 ，2 的 立方 用 2**3 
表示 。 请 创建 一 个 列表 ， 其 中 包含 前 10 个 整数 ( 即 1~10 ) 的 立方 ， 再 使 用 一 个 for 循 
环 将 这 些 立 方 数 都 打印 出 来 。 

4-9 立方 解析 : 使 用 列表 解析 生成 一 个 列表 ， 其 中 包含 前 10 个 整数 的 立方 。 


4.4 使 用 列表 的 一 部 分 


在 第 3 章 中 ， 你 学 习 了 如 何 访问 单个 列表 元 素 。 在 本 章 中 ， 你 一 直 在 学 习 如 何 处 理 列表 的 所 
有 元 素 。 你 还 可 以 处 理 列 表 的 部 分 元 素 一 一 Python 称 之 为 切片 。 


4.4.1 切片 


要 创建 切片 ,可 指定 要 使 用 的 第 一 个 元 素 和 最 后 一 个 元 素 的 索引 。 与 函数 range() 一 样 ,Python 
在 到 达 你 指定 的 第 二 个 索引 前 面 的 元 素 后 停止 。 要 输出 列表 中 的 前 三 个 元 素 , 需要 指定 索引 0~3， 
这 将 输出 分 别 为 0(、1 和 :2 的 元 素 。 

下 面 的 示例 处 理 的 是 一 个 运动 队 成 员 列 表 : 
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players.py 


players = ['charles', 'martina', 'michael', 'florence', 'eli'] 
@ print(players[0:3]) 


@ 处 的 代码 打印 该 列表 的 一 个 切片 ， 其 中 只 包含 三 名 队员 。 输出 也 是 一 个 列表 ， 其 中 包含 前 
三 名 队员 : 


['charles', 'martina', 'michael'] 4 


你 可 以 生成 列表 的 任何 子 集 ， 例 如 ， 如 果 你 要 提取 列表 的 第 2~4 个 元 素 ， 可 将 起 始 索 引 指 定 
为 7， 并 将 终止 索引 指定 为 4: 


players = ['charles', 'martina', 'michael', 'florence', 'eli'] 


print(players[1:4]) 


这 一 次 ， 切 片 始 于 'marita' ， 终 于 'florence': 


['martina', michael'， 'florence'] 


如 果 你 没有 指定 第 一 个 索引 ，Python 将 自动 从 列表 开头 开始 : 


players = [ charles'， 'martina', ‘michael', 'florence', "eli 


邮 print(players[ :4]) 


由 于 没有 指定 起 始 索引 ，Python 从 列表 开头 开始 提取 : 


['charles', 'martina', 'michael', 'florence'] 


要 让 切片 终止 于 列表 末尾 ， 也 可 使 用 类 似 的 语法 。 例 如 ， 如 果 要 提取 从 第 3 个 元 素 到 列表 末 
尾 的 所 有 元 素 ， 可 将 起 始 索 引 指 定 为 2， 并 省 略 终止 索引 : 


players = ['charles', 'martina', 'michael', 'florence', eli |] 
print(players[2:]) 


Python 将 返回 从 第 3 个 元 素 到 列表 未 尾 的 所 有 元 素 : 


['michael', 'florence', 'eli'] 
无 论 列表 多 长 ,这 种 语法 都 能 够 让 你 输出 从 特定 位 置 到 列表 末尾 的 所 有 元 素 。 本 书 前 面 说 过 ， 


负数 索引 返回 离 列表 末尾 相应 距离 的 元 素 , 因此 你 可 以 输出 列表 末尾 的 任何 切片 。 例 如 ,如 果 你 
要 输出 名 单 上 的 最 后 三 名 队员 ， 可 使 用 切片 players[-3:]: 


players ['charles', 'martina', 'michael', 'florence', 'eli'] 
print(players[-3:]) 


上 述 代码 打印 最 后 三 名 队员 的 名 字 ， 即 便 队 员 名 单 的 长 度 发 生变 化 ， 也 依然 如 此 。 
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4.4.2 遍历 切片 


如 果 要 遍历 列表 的 部 分 元 素 ， 可 在 for 循 环 中 使 用 切片 。 在 下 面 的 示例 中 ， 我 们 遍历 前 三 名 
队员 ， 并 打印 他 们 的 名 字 : 


players = ['charles', ‘martina', 'michael', 'florence', 'eli'] 


print("Here are the first three players on my team:") 
@ for player in players[:3]: 
print(player.title()) 


@ 处 的 代码 没有 遍历 整个 队员 列表 ， 而 只 遍历 前 三 名 队员 : 


Here are the first three players on my team: 
Charles 
Martina 
Michael 


在 很 多 情况 下 , 切片 都 很 有 用 。 例 如 ,编写 游戏 时 ,你 可 以 在 玩家 退出 游戏 时 将 其 最 终 得 分 
加 入 到 一 个 列表 中 。 然 后 ,为 获取 该 玩家 的 三 个 最 高 得 分 , 你 可 以 将 该 列表 按 降 序 排列 ,再 创建 
一 个 只 包含 前 三 个 得 分 的 切片 。 处理 数据 时 , 可 使 用 切片 来 进行 批量 处 理 ; 编写 Web 应 用 程序 时 ， 
可 使 用 切片 来 分 页 显示 信息 ， 并 在 每 页 显示 数量 合适 的 信息 。 


4.4.3 复制 列表 


你 经 常 需要 根据 既 有 列表 创建 全 新 的 列表 。 下 面 来 介绍 复制 列表 的 工作 原理 ， 以 及 复制 列表 
可 提供 极 大 帮助 的 一 种 情形 。 

要 复制 列表 , 可 创建 一 个 包含 整个 列表 的 切片 , 方法 是 同时 省 略 起 始 索引 和 终止 索引 ([:] )。 
这 让 Python 创建 一 个 始 于 第 一 个 元 素 ， 终 止 于 最 后 一 个 元 素 的 切片 ， 即 复制 整个 列表 。 

例如 ,假设 有 一 个 列表 ， 其 中 包含 你 最 喜欢 的 四 种 食品 ， 而 你 还 想 创 建 另 一 个 列表 , 在 其 中 
包含 一 位 朋友 喜欢 的 所 有 食品 。 不 过 ,你 喜欢 的 食品 ， 这 位 朋友 都 喜欢 ， 因 此 你 可 以 通过 复制 来 
创建 这 个 列表 : 

foods.py 


@ my foods = ['pizza', 'falafel', 'carrot cake'] 
@ friend foods = my foods[:] 


print("My favorite foods are:") 
print(my_foods) 


print("\nMy friend's favorite foods are:") 

print(friend foods) 

我 们 首先 创建 了 一 个 名 为 my_foods 的 食品 列表 ( 见 @ ), 然后 创建 了 一 个 名 为 friend_foods 的 
新 列表 ( 见 @ )。 我 们 在 不 指定 任何 索引 的 情况 下 从 列表 my_foods 中 提取 一 个 切片 ， 从 而 创建 了 
这 个 列表 的 副本 ， 再 将 该 副本 存储 到 变量 friend foods 中 。 打 印 每 个 列表 后 ， 我 们 发 现 它们 包含 
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的 食品 相同 : 


My favorite foods are: 
['pizza', 'falafel', 'carrot cake'] 


My friend's favorite foods are: 
['pizza', 'falafel', 'carrot cake'] 


为 核实 我 们 确实 有 两 个 列表 , 下 面 在 每 个 列表 中 都 添加 一 种 食品 , 并 核实 每 个 列表 都 记录 了 
相应 人 员 喜 欢 的 食品 : 


my foods = ['pizza', 'falafel', 'carrot cake'] 
@ friend foods = my foods[:] 
@ my foods.append('cannoli') 
©@ friend foods.append('ice cream') 
print("My favorite foods are:") 
print(my_foods) 


print("\nMy friend's favorite foods are:") 
print(friend foods) 


与 前 一 个 示例 一 样 ， 我们 首先 将 my_foods 的 元 素 复制 到 新 列表 friend foods 中 ( 见 @ ), 接 下 
来 , 在 每 个 列表 中 都 添加 一 种 食品 : 在 列表 my_foods 中 添加 'cannoli' ( 见 @ ), 而 在 friend_foods 
中 添加 'ice cream'( 见 @ )。 最 后 ， 打 印 这 两 个 列表 ， 核 实 这 两 种 食品 包含 在 正确 的 列表 中 。 


My favorite foods are: 
@ ['pizza', 'falafel', 'carrot cake', "cannoli 


My friend's favorite foods are: 
加 ['pizza', 'falafel', 'carrot cake', 'ice cream'| 


@ 处 的 输出 表明 ，'cannoli' 包 含 在 你 喜欢 的 食品 列表 中 ， 而 'ice cream' 没 有 。@ 处 的 输出 
表明 ，'ice cream' 包 含 在 你 朋友 喜欢 的 食品 列表 中 ， 而 'cannoli' 没 有 。 倘 阁 我 们 只 是 简单 地 将 
my_foods 赋 给 friend_foods ， 就 不 能 得 到 两 个 列表 。 例 如 ， 下 例 演示 了 在 不 使 用 切片 的 情况 下 复 
制 询 表 的 情况 : 


my_foods = ['pizza', 'falafel', 'carrot cake'] 


# 这 行 不通 
@ friend foods = my foods 


my_foods.append('cannoli') 
friend foods.append('ice cream') 


print("My favorite foods are:") 
print(my_foods) 


print("\nMy friend's favorite foods are:") 
print(friend foods) 
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这 里 将 my_foods 赋 给 friend foods ， 而 不 是 将 my_foods 的 副本 存储 到 friend foods ( 见 @ )。 
这 种 语法 实际 上 是 让 Python 将 新 变量 friend_foods 关 联 到 包含 在 my_foods 中 的 列表 ， 因 此 这 两 个 
变量 都 指向 同一 个 列表 。 鉴 于 此 ， 当 我 们 将 'cannoli' 添 加 到 my foods 中 时 ， 它 也 将 出 现在 
friend_foods 中 ; 同样 ,虽然 'ice cream' 好 像 只 被 加 入 到 了 friend_foods 中 ,但 它 也 将 出 现在 这 
两 个 列表 中 。 

输出 表明 ， 两 个 列表 是 相同 的 ， 这 并 非 我 们 想 要 的 结 引 


‘i 


My favorite foods are: 
['pizza', 'falafel', 'carrot cake', 'cannoli', "ice cream' 


My friend's favorite foods are: 
['pizza', 'falafel', 'carrot cake', 'cannoli', "ice cream' 


注意 现在 暂时 不 要 考虑 这 个 示例 中 的 细节 。 基 本 上 ， 当 你 试图 使 用 列表 的 副本 时 ， 如 果 结 果 
出 乎 意料 ， 请 确认 你 像 第 一 个 示例 那样 使 用 切片 复制 了 列表 。 


动手 试 一 斌 
4-10 切片 : 选择 你 在 本 章 编写 的 一 个 程序 在 末尾 添加 几 行 代码 ， 以 完成 如 下 任务 。 
口 打印 消息 “The first three items in the list are:”， 再 使 用 切片 来 打印 列表 的 前 三 个 
元 
口 打印 消息 “Three items from the middle ofthe list are:”， 再 使 用 切片 来 打印 列表 中 
间 的 三 个 元 素 。 
口 打印 消息 “The last three items in the list are:”， 再 使 用 切片 来 打印 列表 末尾 的 三 
人 
4-11 你 的 比萨 和 我 的 比萨 : 在 你 为 完成 练习 4-1 而 编写 的 程序 中 ,创建 比萨 列表 的 
副本 ， 并 将 其 存储 到 变量 friend pizzas 中 ， 再 完成 如 下 任务 。 
口 在 原来 的 比萨 列表 中 添加 一 种 比萨 。 
口 在 列表 friend pizzas 中 添加 另 一 种 比萨 。 
口 核实 你 有 两 个 不 同 的 列表 。 为 此 ， 打 印 消息 “My favorite pizzas are:”， 再 使 用 一 
个 for 循环 来 打印 第 一 个 列表 ; 打印 消息 “My friend’s favorite pizzas are:”， 再 使 
用 一 个 for 循环 来 打印 第 二 个 列表 。 核 实 新 增 的 比萨 被 添加 到 了 正确 的 列表 中 。 
4-12 使 用 多 个 循环 : 在 本 节 中 ,为 节省 篇 幅 ， 程 序 foods.py 的 每 个 版 本 都 没有 使 用 
for 循环 来 打印 列表 。 请 选择 一 个 版 本 的 foods.py， 在 其 中 编写 两 个 for 循环 ， 将 各 个 
食品 列表 都 打印 出 来 。 


4.5 元 组 

列表 非常 适合 用 于 存储 在 程序 运行 期 间 可 能 变化 的 数据 集 。 列表 是 可 以 修改 的 , 这 对 处 理 网 
站 的 用 户 列表 或 游戏 中 的 角色 列表 至 关 重 要 。 然 而 ， 有 时 候 你 需要 创建 一 系列 不 可 修改 的 元 素 ， 
元 组 可 以 满足 这 种 需求 。Python 将 不 能 修改 的 值 称 为 不 可 变 的 ， 而 不 可 变 的 列表 被 称 为 元 组 。 


4.5.1 定义 元 组 


元 组 看 起 来 犹如 列表 , 但 使 用 圆 括号 而 不 是 方 括号 来 标识 。 定 义 元 组 后 ， 就 可 以 使 用 索引 来 
访问 其 元 素 ， 就 像 访问 列表 元 素 一 样 。 

例如 ， 如 果 有 一 个 大 小 不 应 改变 的 抢 形 , 可 将 其 长 度 和 宽度 存储 在 一 个 元 组 中 ， 从 而 确保 它 
们 是 不 能 修改 的 : 


dimensions.py 


@ dimensions = (200，50) 
@ print(dimensions[0]) 
print(dimensions[1]) 


我 们 首先 定义 了 元 组 dimensions ( 见 @ )， 为 此 我 们 使 用 了 圆 括号 而 不 是 方 括号 。 接 下 来 , 我 
们 分 别 打印 该 元 组 的 各 个 元 素 ， 使 用 的 语法 与 访问 列表 元 素 时 使 用 的 语法 相同 〈 见 @ ): 


200 
50 


下 面 来 尝试 修改 元 组 dimensions 中 的 一 个 元 素 ， 看 看 结果 如 何 : 


imensions = (200，50) 
@ dimensions[0] = 250 


@ 处 的 代码 试图 修改 第 一 个 元 素 的 值 ， 导 致 Python 返 回 类 型 错误 消息 。 由 于 试图 修改 元 组 的 
操作 是 被 禁止 的 ， 因 此 Python 指 出 不 能 给 元 组 的 元 素 赋值 : 


Traceback (most recent call last): 
File "dimensions.py", line 3, in <module> 
dimensions[0] = 250 
TypeError: 'tuple' object does not support item assignment 


代码 试图 修改 矩形 的 尺寸 时 ，Python 报 告 错误 ， 这 很 好 ， 因 为 这 正 是 我 们 希望 的 。 
4.5.2 ”遍历 元 组 中 的 所 有 值 
像 列 表 一 样 ， 也 可 以 使 用 for 循 环 来 遍历 元 组 中 的 所 有 值 : 


dimensions = (200，50) 
for dimension in dimensions: 
print(dimension) 


3 
W 
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就 像 遍 历 列表 时 一 样 ，Python 返 回 元 组 中 所 有 的 元 素 , : 


200 
50 


4.5.3 修改 元 组 变量 


虽然 不 能 修改 元 组 的 元 素 , 但 可 以 给 存储 元 组 的 变量 赋值 。 因 此 ， 如 果 要 修改 前 述 矩 形 的 尺 


寸 ， 可 重新 定义 整个 元 组 : 


@ dimensions 


print("Origi 


(200，50) 


nal dimensions:") 


for dimension in dimensions : 


print(di 


mension) 


@ dimensions = (400, 100) 
@ print("\nModified dimensions:") 
for dimension in dimensions: 


print(di 


mension) 


我 们 首先 定义 了 一 个 元 组 ， 并 将 其 存储 的 尺寸 打印 了 出 来 ( 见 @ ); 接 下 来 ,将 一 个 新 元 组 
存储 到 变量 dimensions 中 ( 见 @ ); 然后 ， 打 印 新 的 尺寸 ( 见 @ )。 这 次 ，Python 不 会 报告 任何 错 


误 ， 因 为 给 元 组 变量 赋值 是 合法 的 : 


Original dimensions : 


200 
50 


Modified dimensions : 


400 
100 


相 比 于 列表 , 元 组 是 更 简单 的 数据 结构 。 如 果 需 要 存储 的 一 组 值 在 程序 的 整个 生命 周期 内 都 
不 变 ， 可 使 用 元 组 。 


动手 试 一 斌 
4-13 自助 餐 : 有 一 家 自助 式 餐 馆 ， 只 提供 五 种 简单 的 食品 。 请 想 出 五 种 简单 的 食 
品 ， 并 将 其 存储 在 一 个 元 组 中 。 


口 使 用 一 个 for 循环 将 该 餐馆 提供 的 五 种 食品 都 打印 出 来 。 


口 尝试 修改 其 中 的 一 个 元 素 ， 核 实 Python 确实 会 拒绝 你 这 样 做 。 
口 餐馆 调整 了 菜单 ， 替 换 了 它 提供 的 其 中 两 种 食品 。 请 编写 一 个 这 样 的 代码 块 : 


给 元 组 变量 赋值 ， 并 使 用 一 个 for 循环 将 新 元 组 的 每 个 元 素 都 打印 出 来 。 
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4.6 设置 代码 格式 


随 着 你 编写 的 程序 越 来 越 长 , 有 必要 了 解 一 些 代码 格式 设置 约定 。 请 花 时 间 让 你 的 代码 尽 可 
能 易于 阅读 ; 让 代码 易于 阅读 有 助 于 你 掌握 程序 是 做 什么 的 ,也 可 以 帮助 他 人 理解 你 编写 的 代码 。 

为 确保 所 有 人 编写 的 代码 的 结构 都 大 致 一 致 ，Python 程 序 员 都 遵循 一 些 格式 设置 约定 。 学 会 
编写 整洁 的 Python 后 ， 就 能 明白 他 人 编写 的 Python 代码 的 整体 结构 一 一 只 要 他 们 和 你 遵循 相同 的 
章 南 。 要 成 为 专业 程序 员 ， 应 从 现在 开始 就 遵循 这 些 指南 ， 以 养 成 良好 的 习惯 。 


4.6.1 格式 设置 指南 


知 要 提出 Python 语言 修改 建议 ， 需 要 编写 Python 改进 提案 (Python Enhancement Proposal， 
PEP )。PEP 8 是 最 古老 的 PEP 之 一 ， 它 向 Python 程序 员 提供 了 代码 格式 设置 指南 。PEP 8 的 篇 幅 很 
长 ,但 大 都 与 复杂 的 编码 结构 相关 。 

Python 格 式 设置 指南 的 编写 者 深 知 ， 代 码 被 阅读 的 次 数 比 编写 的 次 数 多 。 代 码 编写 出 来 后 ， 
调试 时 你 需要 阅读 它 ; 给 程序 添加 新 功能 时 ， 需 要 花 很 长 的 时 间 阅 读 代 码 ; 与 其 他 程序 员 分 享 代 
码 时 ， 这 些 程序 员 也 将 阅读 它们 。 

如 果 一 定 要 在 让 代码 易于 编写 和 易于 阅读 之 间 做 出 选择 ，Python 程 序 员 几乎 总 是 会 选择 后 
者 。 下 面 的 指南 可 帮助 你 从 一 开始 就 编写 出 清晰 的 代码 。 


4.6.2 缩 进 


PEP 8 建议 每 级 缩 进 都 使 用 四 个 空格 ， 这 有 既 可 提高 可 读 性 ， 又 和 留 下 了 足够 的 多 级 缩 进 空间 。 

在 字 处 理 文档 中 , 大 家 常常 使 用 制 表 符 而 不 是 空格 来 缩 进 。 对 于 字 处 理 文档 来 说 ,这 样 做 的 
效果 很 好 ,但 混合 使 用 制 表 符 和 空格 会 让 Python 解释 器 感到 迷惑 。 每 款 文本 编辑 器 都 提供 了 一 种 
设置 , 可 将 输入 的 制 表 符 转换 为 指定 数量 的 空格 。 你 在 编写 代码 时 应 该 使 用 制 表 符 键 , 但 一 定 要 
对 编辑 器 进行 设置 ， 使 其 在 文档 中 搬入 空格 而 不 是 制 表 符 。 

在 程序 中 混合 使 用 制 表 符 和 空格 可 能 导致 极 难 解决 的 问题 。 如 果 你 混合 使 用 了 制 表 符 和 空 
格 ， 可 将 文件 中 所 有 的 制 表 符 转换 为 空格 ， 大 多 数 编辑 器 都 提供 了 这 样 的 功能 。 


4.6.3 人 行 长 


很 多 Python 程序 员 都 建议 每 行 不 超过 80 字 符 。 最 初 制定 这 样 的 指南 时 ， 在 大 多 数 计算 机 中 ， 
终端 窗口 每 行 只 能 容纳 79 字 符 ; 当前 , 计算 机 屏幕 每 行 可 容纳 的 字符 数 多 得 多 , 为何 还 要 使 用 79 
字符 的 标准 行 长 呢 ? 这 里 有 别 的 原因 。 专 业 程 序 员 通常 会 在 同一 个 屏幕 上 打开 多 个 文件 , 使 用 标 
准 行 长 可 以 让 他 们 在 屏幕 上 并 排 打开 两 三 个 文件 时 能 同时 看 到 各 个 文件 的 完整 行 。PEP 8 还 建议 
注释 的 行 长 都 不 超过 72 字 符 , 因为 有 些 工 具 为 大 型 项 目 自动 生成 文档 时 , 会 在 每 行 注释 开头 添加 
格式 化 字符 。 

PEP 8 中 有 关 行 长 的 指南 并 非 不 可 逾越 的 红线 ， 有 些小 组 将 最 大 行 长 设置 为 99 字 符 。 在 学 习 
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期 间 ， 你 不 用 过 多 地 考虑 代码 的 行 长 ,但 别 忘 了 ， 协 作 编 写 程序 时 ， 大 家 几乎 都 遵守 PEP 8 指南 。 
在 大 多 数 编辑 器 中 ,都 可 设置 一 个 视觉 标志 一 一 通常 是 一 条 竖 线 , 让 你 知道 不 能 越过 的 界线 在 什 
么 地 方 。 


注意 ”附录 B 介 绍 了 如 何 配 置 文 本 编辑 器 ,以 使 其 : 在 你 按 制 表 符 键 时 插入 四 个 空格 ; 显示 一 条 
垂直 参考 线 ， 帮 助 你 遵守 行 长 不 能 超过 79 字 符 的 约定 。 


4.6.4 ” 空 行 


要 将 程序 的 不 同 部 分 分 开 ， 可 使 用 空 行 。 你 应 该 使 用 空 行 来 组 织 程序 文件 ， 但 也 不 能 滥用 ; 
只 要 按 本 书 的 示例 展示 的 那样 做 ， 就 能 掌握 其 中 的 平衡 。 例 如 ， 如 果 你 有 5 行 创建 列表 的 代码 ， 
还 有 3 行 处 理 该 列表 的 代码 ， 那 么 用 一 个 空 行将 这 两 部 分 隔 开 是 合适 的 。 然 而 ， 你 不 应 使 用 三 四 
个 空 行将 它们 隔 开 。 

空 行 不 会 影响 代码 的 运行 ,但 会 影响 代码 的 可 读 性 。Python 解 释 器 根据 水 平 缩 进 情况 来 解读 
代码 ， 但 不 关心 垂直 间距 。 


4.6.5 ”其 他 格式 设置 指南 


PEP 8 还 有 很 多 其 他 的 格式 设置 建议 , 但 这 些 指南 针对 的 程序 大 都 比 目 前 为 止 本 书 提 到 的 程 
序 复 杂 。 等 介绍 更 复杂 的 Python 结构 时 ， 我 们 再 来 分 享 相关 的 PEP 8 指南 。 


动手 试 一 斌 
4-14 PEP 8: 请 访问 https://python.org/dev/peps/pep-0008/， 阅 读 PEP 8 格式 设置 指 
当前 ， 这 些 指 南 适 用 的 不 多 ,但 你 可 以 大 致 浏览 一 下 。 
4-15 代码 审核 : 从 本 章 编 写 的 程序 中 选择 三 个 ,根据 PEP 8 指南 对 它们 进行 修改 。 
口 每 级 缩 进 都 使 用 四 个 空格 。 对 你 使 用 的 文本 编辑 器 进行 设置 ， 使 其 在 你 按 Tab 


键 时 都 插入 四 个 空格 ; 如 果 你 还 没有 这 样 做 ， 现 在 就 去 做 吧 ( 有 关 如 何 设置 ， 
请 参阅 附录 B )。 

口 每 行 都 不 要 超过 80 字符 。 对 你 使 用 的 编辑 器 进行 设置 , 使 其 在 第 80 个 字符 处 显 
示 一 条 重 直 参考 线 。 

口 不 要 在 程序 文件 中 过 多 地 使 用 空 行 。 
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4.7 小 结 


在 本 章 中 ， 你 学 习 了 : 如 何 高 效 地 处 理 列表 中 的 元 素 ; 如 何 使 用 for 循 环 遍历 列表 ，Python 
如 何 根据 缩 进 来 确定 程序 的 结构 以 及 如 何 避 免 一 些 常 见 的 缩 进 错误 ;如 何 创建 简单 的 数字 列表 ， 
以 及 可 对 数字 列表 执行 的 一 些 操 作 ; 如 何 通过 切片 来 使 用 列表 的 一 部 分 和 复制 列表 。 你 还 学 习 了 
元 组 ( 它 对 不 应 变化 的 值 提供 了 一 定 程度 的 保护 ) 以 及 在 代码 变 得 越 来 越 复杂 时 如 何 设置 格式 ， 
使 其 易于 阅读 。 

在 第 5 章 中 ， 你 将 学 习 如 何 使 用 if 语 名 在 不 同 的 条 件 下 采取 不 同 的 措施 ; 学 习 如 何 将 一 组 较 
复杂 的 条 件 测试 组 合 起 来 ,并 在 满足 特定 条 件 时 采取 相应 的 措施 。 你 还 将 学 习 如 何在 遍历 列表 时 ， 
通过 使 用 if 语句 对 特定 元 素 采 取 特 定 的 措施 。 


第 5 章 


if 语 句 


编程 时 经 常 需 要 检查 一 系列 条 件 , 并 据 此 决定 采取 什么 措施 。 在 
Python 中 ， if 语句 让 你 能 够 检查 程序 的 当前 状态 ， 并 据 此 采取 相应 的 
苦 施 。 

在 本 章 中 ,你 将 学 习 条 件 测 试 ， 以 检查 感 兴趣 的 任何 条 件 。 你 将 
学 习 简 单 的 jf 语句 , 以 及 创建 一 系列 复杂 的 if 语 句 来 确定 当前 到 底 处 
于 什么 情形 。 接 下 来 ， 你 将 把 学 到 的 知识 应 用 于 列表 ， 以 编写 for 循 
环 , 以 一 种 方式 处 理 列表 中 的 大 多 数 元 素 , 并 以 另 一 种 不 同 的 方式 处 
理 包 含 特定 值 的 元 素 。 


5.1 一 个 简单 示例 

下 面 是 一 个 简短 的 示例 , 演示 了 如 何 使 用 if 语 句 来 正确 地 处 理 特殊 情形 。 假设 你 有 一 个 汽车 
列表 ,并 想 将 其 中 每 辆 汽车 的 名 称 打印 出 来 。 对 于 大 多 数 汽车 ,都 应 以 首 字母 大 写 的 方式 打印 其 
名 称 ， 但 对 于 汽车 名 'bmw' ， 应 以 全 大 写 的 方式 打印 。 下 面 的 代码 遍历 一 个 列表 ， 并 以 首 字 母 大 
写 的 方式 打印 其 中 的 汽车 名 ， 但 对 于 汽车 名 'bmw' ， 以 全 大 写 的 方式 打印 : 


cars.py 


cars = ['audi', 'bmw', 'subaru', 'toyota'] 


for car in cars: 
© if car == 'bmw': 
print(car.upper()) 
else: 
print(car.title()) 


这 个 示例 中 的 循环 首先 检查 当前 的 汽车 名 是 否 是 'bmw'( 见 @ )。 如 果 是 ,就 以 全 大 写 的 方式 
打印 它 ; 否则 就 以 首 字 母 大 写 的 方式 打印 : 
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Audi 
BMW 
Subaru 
Toyota 


这 个 示例 涵盖 了 本 音 将 介绍 的 很 多 概念 。 下 面 先 来 介绍 可 用 来 在 程序 中 检查 条 件 的 测试 。 
5.2 条 件 测试 

每 条 if 语句 的 核心 都 是 一 个 值 为 True 或 False 的 表达 式 , 这 种 表达 式 被 称 为 条 件 测试 , Python 5 
根据 条 件 测试 的 值 为 True 还 是 False 来 决定 是 否 执行 if 语 句 中 的 代码 。 如 果 条 件 测试 的 值 为 True， 
Python 就 执行 紧 跟 在 if 语 句 后 面 的 代码 ; 如 果 为 False，Python 就 忽略 这 些 代 码 。 


5.2.1 检查 是 否 相 等 


大 多 数 条 件 测试 都 将 一 个 变量 的 当前 值 同 特定 值 进行 比较 。 最 简单 的 条 件 测试 检查 变量 的 值 
是 否 与 特定 值 相等 : 


@ >>> car = “bmw' 
@ >>> car == “bmw' 
True 


我 们 首先 使 用 一 个 等 号 将 car 的 值 设置 为 'bmw'( 见 @ )， 这 种 做 法 你 已 见 过 很 多 次 。 接 下 来 ， 
使 用 两 个 等 号 ( == ) 检查 car 的 值 是 否 为 'bmw' 。 这 个 相等 运算 符 在 它 两 边 的 值 相 等 时 返回 True， 
否则 返回 False。 在 这 个 示例 中 ， 两 边 的 值 相 等 ， 因 此 Python 返 回 True。 

如 果 变 量 car 的 值 不 是 'bmw' ， 上 述 测试 将 返回 False: 


@ >>> car = 'audi' 
@ >>> car == 'bmw' 
False 


个 等 号 是 陈述 ; 对 于 @ 处 的 代码 ， 可 解读 为 “将 变量 car 的 值 设 置 为 'audi'”。 两 个 等 号 是 
发 问 ; 对 于 @ 处 的 代码 ， 可 解读 为 “变量 car 的 值 是 'bmw' 吗 ? ”。 大 多 数 编程 语言 使 用 等 号 的 方 
式 都 与 这 里 演示 的 相同 。 


5.2.2 检查 是 否 相等 时 不 考虑 大 小 写 
在 Python 中 检查 是 否 相 等 时 区 分 大 小 写 ， 例 如 ， 两 个 大 小 写 不 同 的 值 会 被 视 为 不 相等 : 


>>> car = "Audi' 
>>> car == "audi' 
False 
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如 果 大 小 写 很 重要 ， 这 种 行为 有 其 优点 。 但 如 果 大 小 写 无 关 紧 要 ， 而 只 想 检 查 变量 的 值 ， 可 
将 变量 的 值 转换 为 小 写 ， 再 进行 比较 : 


>>> car = "Audi' 
>>> car.lower() == 'audi' 
True 


无 论 值 'Audi' 的 大 小 写 如何 , 上 述 测试 都 将 返回 True, 因 为 该 测试 不 区 分 大 小 写 。 子 数 lower() 
不 会 修改 存储 在 变量 car 中 的 值 ， 因 此 进行 这 样 的 比较 时 不 会 影响 原来 的 变量 : 


@ >>> car = 'Audi' 

@ >>> car.lower() == 'audi' 
True 

©@ >>> car 
"Audi 


在 @ 处 ,我 们 将 首 字母 大 写 的 字符 串 'Audi' 存 储 在 变量 car 中 ; 在 @ 处 ,我 们 获取 变量 car 的 
值 并 将 其 转换 为 小 写 ， 青 将 结果 与 字符 串 'audi' 进 行 比较 。 这 两 个 字符 串 相 同 ， 因 此 Python 返 回 
True。 从 四 处 的 输出 可 知 ， 这 个 条 件 测 试 并 没有 影响 存储 在 变量 car 中 的 值 。 

网 站 采用 类 似 的 方式 让 用 户 输入 的 数据 符合 特定 的 格式 。 例 如 , 网 站 可 能 使 用 类 似 的 测试 来 
确保 用 户 名 是 独一无二 的 ， 而 并 非 只 是 与 另 一 个 用 户 名 的 大 小 写 不 同 。 用 户 提 交 新 的 用 户 名 时 ， 
将 把 它 转换 为 小 写 , 并 与 所 有 既 有 用 户 和 名 的 小 写 版 本 进行 比较 。 执 行 这 种 检查 时 ， 如 果 已 经 有 用 
户 名 'john" (不 管 大 小 写 如 何 )， 则 用 户 提交 用 户 名 'John' 时 将 遭 到 拒绝 。 


5.2.3 ”检查 是 否 不 相等 


要 判断 两 个 值 是 否 不 等 ， 可 结合 使 用 惊叹 号 和 等 号 ( != )， 其 中 的 惊叹 号 表示 不 ， 在 很 多 编 
程 语言 中 都 如 此 。 

下 面 再 使 用 一 条 if 语句 来 演示 如 何 使 用 不 等 运算 符 。 我 们 将 把 要 求 的 比萨 配料 存储 在 一 个 变 
量 中 ， 再 打印 一 条 消息 ， 指 出 顾客 要 求 的 配料 是 否 是 意 式 小 银 鱼 ( anchovies ): 


toppings.py 


requested topping = 'mushrooms’ 


@ if requested topping != "anchovies': 
print("Hold the anchovies!") 


@ 处 的 代码 行将 requested topping 的 值 与 'anchovies' 进 行 比较 ， 如 果 它 们 不 相等 ，Python 
将 返回 True， 进 而 执行 紧 跟 在 if 语 句 后 面 的 代码 ; 如 果 这 两 个 值 相等 ，Python 将 返回 False， 因 此 
不 执行 紧 跟 在 if 语 句 后 面 的 代码 。 

由 于 requested topping 的 值 不 是 'anchovies' ， 因 此 执行 print 语 人 句 : 
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Hold the anchovies! 


你 编写 的 大 多 数 条 件 表达 式 都 检查 两 个 值 是 否 相 等 ,但 有 时 候 检查 两 个 值 是 否 不 等 的 效率 


更 高 。 
5.2.4 比较 数字 
检查 数值 非常 简单 ， 例 如 ， 下 面 的 代码 检查 一 个 人 是 否 是 18 岁 : 


>>> age = 18 
>>> age == 18 
True 


你 还 可 以 检查 两 个 数字 是 否 不 等 ， 例 如 ， 下 面 的 代码 在 提供 的 答案 不 正确 时 打印 一 条 消息 : 


magic_ number.py 


answer = 17 


@ if answer != 42: 
print("That is not the correct answer. Please try again!") 


answer ( 17 ) 不 是 42，@ 处 的 条 件 得 到 满足 ， 因 此 缩 进 的 代码 块 得 以 执行 : 


That is not the correct answer. Please try again! 


条 件 语句 中 可 包含 各 种 数学 比较 ， 如 小 于 、 小 于 等 于 、 大 于 、 大 于 等 于 : 


>>> age = 19 
>>> age < 21 
True 
>>> age <= 21 
True 
>>> age > 21 
False 
>>> age >= 21 
False 


在 if 语句 中 可 使 用 各 种 数学 比较 ， 这 让 你 能 够 直接 检查 关心 的 条 件 。 
5.2.5 ”检查 多 个 条 件 


你 可 能 想 同时 检查 多 个 条 件 , 例如 , 有 时 候 你 需要 在 两 个 条 件 都 为 True 时 才 执 行 相应 的 操作 ， 
而 有 时 候 你 只 要 求 一 个 条 件 为 True 时 就 执行 相应 的 操作 。 在 这 些 情 况 下 ， 关 键 字 and 和 or 可 助 你 
一 辟 之 力 。 

1. 使 用 and 检 查 多 个 条 件 

要 检查 是 否 两 个 条 件 都 为 True， 可 使 用 关键 字 and 将 两 个 条 件 测试 合 而 为 一 ; 如 果 每 个 测试 
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都 通过 了 ， 整 个 表达 式 就 为 True; 如 果 至 少 有 一 个 测试 没有 通过 ， 整 个 表达 式 就 为 False。 
例如 ， 要 检查 是 否 两 个 人 都 不 小 于 21 岁 ， 可 使 用 下 面 的 测试 : 


@ >>>age 0 = 22 
>>> age 1 = 18 

@ >>> age 0 >= 21 and age 1 >= 21 
False 

@ >>> age 1 = 22 
>>> age 0 >= 21 and age 1 >= 21 
True 


在 @ 处 ,我们 定义 了 两 个 用 于 存储 年 龄 的 变量 : age 0 和 age_1。 在 @ 处 ,我们 检查 这 两 个 变 
量 是 否 都 大 于 或 等 于 21; 左边 的 测试 通过 了 , 但 右边 的 测试 没有 通过 ， 因 此 整个 条 件 表达 式 的 结 
果 为 False。 在 @ 处 ,我 们 将 age 1 改 为 22， 这样 age_ 1 的 值 大 于 21， 因 此 两 个 测试 都 通过 了 ， 导 致 
整个 条 件 表达 式 的 结果 为 True。 

为 改善 可 读 性 , 可 将 每 个 测试 都 分 别 放 在 一 对 括号 内 , 但 并 非 必 须 这 样 做 。 如 果 你 使 用 括号 ， 
测试 将 类 似 于 下 面 这 样 : 


(age 0 >= 21) and (age 1 >= 21) 


2. 使 用 or 检查 多 个 条 件 

关键 字 or 也 能 够 让 你 检查 多 个 条 件 ,但 只 要 至 少 有 一 个 条 件 满足 ， 就 能 通过 整个 测试 。 仅 当 
两 个 测试 都 没有 通过 时 ， 使 用 or 的 表达 式 才 为 False。 

下 面 再 次 检查 两 个 人 的 年 龄 ， 但 检查 的 条 件 是 至 少 有 一 个 人 的 年 龄 不 小 于 21 岁 : 


@ >>> age 0 = 22 
>>> age_1 = 18 
>>> age 0 >= 21 or age 1 >= 21 
True 
@ >>> age_0 = 18 
>>> age 0 >= 21 or age 1 >= 21 
False 
同样 ， 我 们 首先 定义 了 两 个 用 于 存储 年 龄 的 变量 ( 见 @ )。 由 于 @ 处 对 age_0 的 测试 通过 了 ， 
因此 整个 表达 式 的 结果 为 True。 接 下 来 ,我 们 将 age_0 减 小 为 18; 在 四 处 的 测试 中 ,两 个 测试 都 没 
有 通过 ， 因 此 整个 表达 式 的 结果 为 False。 


5.2.6 ”检查 特定 值 是 否 包含 在 列表 中 


有 时 候 ， 执 行 操 作 前 必须 检查 列表 是 否 包 含 特定 的 值 。 例 如 ， 结 束 用 户 的 注册 过 程 前 ， 可 能 
需要 检查 他 提供 的 用 户 名 是 否 已 包含 在 用 户 名 列表 中 。 在 地 图 程序 中 , 可 能 需要 检查 用 户 提交 的 
位 置 是 否 包含 在 已 知 位 置 列表 中 。 

要 判断 特定 的 值 是 否 已 包含 在 列表 中 , 可 使 用 关键 字 in。 来 看 你 可 能 为 比萨 店 编写 的 一 些 代 
码 ; 这 些 代 码 首先 创建 一 个 列表 , 其 中 包含 用 户 点 的 比萨 配料 ， 然 后 检查 特定 的 配料 是 否 包 含 在 


@ 
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该 列表 中 。 


>>> requested toppings = ['mushrooms', 'onions', 'pineapple'] 
@ >>> "mushrooms' in requested toppings 

True 
@ >>> "pepperoni' in requested toppings 

False 


在 四 处 和 四处 ， 关 键 字 in 让 Python 检查 列表 requested toppings 是 否 包 含 'mushrooms' 和 
'pepperoni' 。 这 种 技术 很 有 用 ， 它 让 你 能 够 在 创建 一 个 列表 后 ， 轻 松 地 检查 其 中 是 否 包含 特定 
的 值 。 


5.2.7 ”检查 特定 值 是 否 不 包含 在 列表 中 


还 有 些 时 候 ， 确 定 特定 的 值 未 包含 在 列表 中 很 重要 ; 在 这 种 情况 下 ， 可 使 用 关键 字 not in。 
例如 ， 如 果 有 一 个 列表 ， 其 中 包含 被 禁止 在 论坛 上 发 表 评 论 的 用 户 ， 就 可 在 允许 用 户 提交 评论 前 
检查 他 是 否 被 禁 言 : 


banned_users.py 


banned users = ['andrew', 'carolina', 'david'] 
user = 'marie’ 


@ if user not in banned users: 
print(user.title() + ", you can post a response if you wish.") 


@ 处 的 代码 行 明白 易 懂 : 如 果 user 的 值 未 包含 在 列表 banned_users 中 ，Python 将 返回 True， 
进而 执行 缩 进 的 代码 行 。 
用 户 'marie' 示 包含 在 列表 banned_users 中 ， 因 此 她 将 看 到 一 条 邀请 她 发 表 评 论 的 消息 : 


Marie, you can post a response if you wish. 


5.2.8 布尔 表达 式 


随 着 你 对 编程 的 了 解 越 来 越 深 入 , 将 遇 到 术语 布尔 表达 式 , 它 不 过 是 条 件 测试 的 别名 。 与 条 
件 表达 式 一 样 ， 布 尔 表 达 式 的 结果 要 么 为 True， 要 么 为 False。 
布尔 值 通常 用 于 记录 条 件 ， 如 游戏 是 否 正在 运行 ， 或 用 户 是 否 可 以 编辑 网 站 的 特定 内 容 : 


game _active = True 
can edit = False 


在 跟踪 程序 状态 或 程序 中 重要 的 条 件 方面 ， 布 尔 值 提供 了 一 种 高 效 的 方式 。 
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动手 试 一 斌 
5-1 条 件 测试 : 编写 一 系列 条 件 测试 ; 将 每 个 测试 以 及 你 对 其 结果 的 预测 和 实际 结 
果 都 打印 出 来 。 你 编写 的 代码 应 类 似 于 下 面 这 样 ， 


Ean subanw 
print("Is car == 'subaru'? 1 predict True.") 
print(car == 'subaru') 


print("\nIs car == 'audi'? I predict False.") 
(ee = lu ) 


口 详细 研究 实际 结果 ， 直 到 你 明白 了 它 为 何 为 True 或 False。 

口 创建 至 少 10 个 测试 ， 且 其 中 结果 分 别 为 True 和 False 的 测试 都 至 少 有 5 个 。 
S-2 更 多 的 条 件 测试 : 你 并 非 只 能 创建 10 个 测试 。 如 果 你 想 尝 试 做 更 多 的 比较 ， 可 

再 编写 一 些 测试 ， 并 将 它们 加 入 到 conditional tests.py 中 。 对 于 下 面 列 出 的 各 种 测试 ， 

至 少 编写 一 个 结果 为 True 和 False 的 测试 。 

口 检查 两 个 字符 串 相 等 和 不 等 。 

口 使 用 函数 lower() 的 测试 。 

口 检查 两 个 数字 相等 、 不 等 、 大 于 、 小 于 、 大 于 等 于 和 小 于 等 于 。 

口 使 用 关键 字 and 和 or 的 测试 。 

口 测试 特定 的 值 是 否 包含 在 列表 中 。 

口 测试 特定 的 值 是 否 未 包含 在 列表 中 。 


5.3 ”if 语句 


理解 条 件 测试 后 ， 就 可 以 开始 编写 if 语 句 了 。if 语 句 有 很 多 种 ， 选 择 使 用 哪 种 取决 于 要 测试 
的 条 件数 。 前 面 讨论 条 件 测试 时 ， 列 举 了 多 个 if 语 名 示例 ， 下 面 更 深入 地 讨论 这 个 主题 。 


5.3.1 简单 的 if 语句 


最 简单 的 if 语句 只 有 一 个 测试 和 一 个 操作 : 


if conditional test: 
do something 


在 第 1 行 中 ,可 包含 任何 条 件 测试 , 而 在 紧 跟 在 测试 后 面 的 缩 进 代码 块 中 ,可 执行 任何 操作 。 


如 果 条 件 测试 的 结果 为 True，Python 就 会 执行 紧 跟 在 if 语 句 后 面 的 代码 ; 否则 Python 将 忽略 这 些 
代码 。 
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假设 有 一 个 表示 某 人 年 龄 的 变量 ， 而 你 想 知 道 这 个 人 是 否 够 投票 的 年 龄 ， 可 使 用 如 下 代码 : 
voting.py 
age = 19 


@ if age >= 18: 
2 print("You are old enough to vote!") 


在 @ 人 处, Python 检查 变量 age 的 值 是 否 大 于 或 等 于 18; 答案 是 肯定 的 ， 因 此 Python 执 行 @ 处 缩 
进 的 print 语 人 句 : 


You are old enough to votel 


在 计 语 句 中 ， 缩 进 的 作用 与 for 循 环 中 相同 。 如 果 测 试 通过 了 ， 将 执行 计 语 句 后 面 所 有 缩 进 
的 代码 行 ， 否 则 将 忽略 它们 。 

在 紧 跟 在 if 语句 后 面 的 代码 块 中 , 可 根据 需要 包含 任意 数量 的 代码 行 。 下 面 在 一 个 人 够 投票 
的 年 龄 时 再 打印 一 行 输出 ， 问 他 是 否 登记 了 : 


age = 19 

if age >= 18: 
print("You are old enough to vote!") 
print("Have you registered to vote yet?") 


条 件 测试 通过 了 ， 而 两 条 print 语 句 都 缩 进 了 ， 因 此 它们 都 将 执行 : 


You are old enough to votel 
Have you registered to vote yet? 


如 果 age 的 值 小 于 18， 这 个 程序 将 不 会 有 任何 输出 。 


5.3.2 ”if-else 语句 


经 常 需要 在 条 件 测试 通过 了 时 执行 一 个 操作 , 并 在 没有 通过 时 执行 另 一 个 操作 ; 在 这 种 情况 
下 ， 可 使 用 Python 提供 的 if-else 语 句 。jif-else 语 句 块 类 似 于 简单 的 放 语 句 ， 但 其 中 的 else 语 句 
让 你 能 够 指定 条 件 测试 未 通过 时 要 执行 的 操作 。 

下 面 的 代码 在 一 个 人 够 投票 的 年 龄 时 显示 与 前 面相 同 的 消息 , 同时 在 这 个 人 不 够 投票 的 年 龄 
时 也 显示 一 条 消息 : 


age = 17 

@ if age >= 18: 

print("You are old enough to vote!") 

print("Have you registered to vote yet?") 

@ else: 

print("Sorry, you are too young to vote.") 

print("Please register to vote as soon as you turn 18!") 
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如 果 @ 处 的 条 件 测试 通过 了 ， 就 执行 第 一 个 缩 进 的 print 语 句 块 ;如 果 测 试 结果 为 False， 就 
执行 @@ 处 的 else 代 码 块 。 这 次 age 小 于 18， 条 件 测试 未 通过 ， 因 此 执行 else 代 码 块 中 的 代码 : 


Sorry, you are too young to vote . 
Please register to vote as soon as you turn 18! 


上 述 代 码 之 所 以 可 行 ， 是 因为 只 存在 两 种 情形 : 要 么 够 投票 的 年 龄 ， 要 么 不 够 。if-else 结 
构 非 常 适合 用 于 要 让 Python 执行 两 种 操作 之 一 的 情形 。 在 这 种 简单 的 if-else 结 构 中 , 总 是 会 执行 
两 个 操作 中 的 一 个 。 


5.3.3 jf-elif-else 结构 


经 常 需要 检查 超过 两 个 的 情形 ， 为 此 可 使 用 Python 提供 的 if-elif-else 结 构 。Python 只 执行 
if-elif-else 结 构 中 的 一 个 代码 块 ， 它 依次 检查 每 个 条 件 测试 ， 直 到 遇 到 通过 了 的 条 件 测试 。 测 
试 通 过 后 ，Python 将 执行 紧 跟 在 它 后 面 的 代码 ， 并 跳 过 余下 的 测试 。 

在 现实 世界 中 , 很 多 情况 下 需要 考虑 的 情形 都 超过 两 个 。 例 如 , 来 看 一 个 根据 年 龄 段 收 费 的 
游乐 场 : 

口 4 岁 以 下 免费 ; 
D 4~18 岁 收费 5 美元 ; 
口 18 岁 ( 含 ) 以 上 收费 10 美 元 。 

如 果 只 使 用 一 条 if 语句 ， 如 何 确定 门票 价格 呢 ? 下 面 的 代码 确定 一 个 人 所 属 的 年 龄 段 ,并 打 
印 一 条 包含 门票 价格 的 消息 : 


amusement_park.py 


age = 12 


@ if age < 4: 
print("Your admission cost is $0.") 
@ elif age < 18: 
print("Your admission cost is $5.") 
®@ else: 
print("Your admission cost is $10.") 


@ 处 的 if 测 试 检查 一 个 人 是 否 不 满 4 岁 ， 如 果 是 这 样 ，Python 就 打印 一 条 合适 的 消息 ， 并 跳 
过 余下 的 测试 。@ 处 的 elif 代 码 行 其 实 是 男 一 个 i 测试 ， 它 仪 在 前 面 的 测试 未 通过 时 才 会 运行 。 
在 这 里 ， 我 们 知道 这 个 人 不 小 于 4 岁 ， 因 为 第 一 个 测试 未 通过 。 如 果 这 个 人 未 满 18 岁 ，Python 将 
打印 相应 的 消息 ， 并 跳 过 else 代 码 块 。 如 果 if 测 试 和 elif 测 试 都 未 通过 ，Python 将 运行 @ 处 else 
代码 块 中 的 代码 。 

在 这 个 示例 中 ，@ 处 测试 的 结果 为 False， 因 此 不 执行 其 代码 块 。 然 而 ， 第 二 个 测试 的 结 
为 True ( 12 小 于 18 )， 因 此 将 执行 其 代码 块 。 输 出 为 一 个 句子 ， 向 用 户 指 出 了 门票 价格 : 


Your admission cost is $5. 
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只 要 年 龄 超过 17 岁 ， 前 两 个 测试 就 都 不 能 通过 。 在 这 种 情况 下 ， 将 执行 else 代 码 块 ， 指 出 门 
票 价 格 为 10 美 元 。 

为 让 代码 更 简洁 ， 可 不 在 if-elif-else 代 码 块 中 打印 门票 价格 ， 而 只 在 其 中 设置 门票 价格 ， 
并 在 它 后 面 添加 一 条 简单 的 print 语 句 : 


age = 12 
if age < 4: 


© price = 0 
elif age < 18: 5 


2 price = 5 


@ print("Your admission cost is $" + str(price) + ".") 


@ 处 、@ 处 和 @ 处 的 代码 行 像 前 一 个 示例 那样 ， 根 据 人 的 年 龄 设置 变量 price 的 值 。 在 
if-elif-else 结 构 中 设置 price 的 值 后， 一 条 未 缩 进 的 print 语 句 @ 会 根据 这 个 变量 的 值 打 印 一 条 
消息 ， 指 出 门票 的 价格 。 

这 些 代码 的 输出 与 前 一 个 示例 相同 ， 但 if-elif-else 结 构 的 作用 更 小 ， 它 只 确定 门票 价格 ， 
而 不 是 在 确定 门票 价格 的 同时 打印 一 条 消息 。 除 效率 更 高 外 ， 这 些 修订 后 的 代码 还 更 容易 修改 : 
要 调整 输出 消息 的 内 容 ， 只 需 修改 一 条 而 不 是 三 条 print 语 句 。 


5.3.4 ”使 用 多 个 elif 代码 块 


可 根据 需要 使 用 任意 数量 的 elif 代 码 块 , 例如 , 假设 前 述 游乐 场 要 给 老年 人 打折 ,可 再 添加 
一 个 条 件 测试 , 判断 顾客 是 否 符合 打折 条 件 。 下面 假 设 对 于 65 岁 ( 含 ) 以 上 的 老人 , 可 以 半价 ( 即 
5 美元 ) 购买 门票 : 


age = 12 
if age < 4: 
price = 0 
elif age < 18: 
price = 5 
@ elif age < 65: 
price = 10 
@ else: 
price = 5 
print("Your admission cost is $" + str(price) + ".") 


这 些 代码 大 都 未 变 。 第 二 个 elif 代 码 块 ( 见 @ ) 通过 检查 确定 年 龄 不 到 65 岁 后 ， 才 将 门票 价 
格 设置 为 全 票 价格 一 一 10 美 元 。 请 注意 ， 在 else 代 码 块 ( 见 @ ) 中 ， 必 须 将 所 赋 的 值 改 为 $， 
为 仅 当年 龄 超过 65 ( 含 ) 时 ， 才 会 执行 这 个 代码 块 。 
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5.3.5 ”省 略 else 代码 块 


Python 并 不 要 求 if-elif 结 构 后 面 必须 有 else 代 码 块 。 在 有 些 情况 下 ，else 代 码 块 很 有 用 ; 而 
在 其 他 一 些 情况 下 ， 使 用 一 条 elif 语 句 来 处 理 特定 的 情形 更 清晰 : 


age = 12 


if age < 4: 
price = 0 
elif age < 18: 
price = 5 
elif age < 65: 
price = 10 
@ elif age >= 65: 
price = 5 


print("Your admission cost is $" + str(price) + ".") 


@ 处 的 elif 代 码 块 在 顾客 的 年 龄 超过 65 ( 含 ) 时 ， 将 价格 设置 为 5 美元 ， 这 比 使 用 else 代 码 
块 更 清晰 些 。 经 过 这 样 的 修改 后 ， 每 个 代码 块 都 仅 在 通过 了 相应 的 测试 时 才 会 执行 。 

else 是 一 条 包罗 万 象 的 语句 , 只 要 不 满足 任何 if 或 elif 中 的 条 件 测试 , 其 中 的 代码 就 会 执行 ， 
这 可 能 会 引入 无 效 甚至 恶意 的 数据 。 如 果 知 道 最 终 要 测试 的 条 件 ， 应 考虑 使 用 一 个 elif 代 码 块 来 
代替 else 代 码 块 。 这 样 ， 你 就 可 以 肯定 ， 仅 当 满 足 相应 的 条 件 时 ， 你 的 代码 才 会 执行 。 


5.3.6 ”测试 多 个 条 件 


if-elif-else 结 构 功能 强大 , 但 仅 适 合用 于 只 有 一 个 条 件 满足 的 情况 : 遇 到 通过 了 的 测试 后 ， 
Python 就 跳 过 余下 的 测试 。 这 种 行为 很 好 ， 效 率 很 高 ， 让 你 能 够 测试 一 个 特定 的 条 件 。 

然而 ， 有 时 候 必须 检查 你 关心 的 所 有 条 件 。 在 这 种 情况 下 ， 应 使 用 一 系列 不 包含 elif 和 else 
代码 块 的 简单 if 语句 。 在 可 能 有 多 个 条 件 为 True， 且 你 需要 在 每 个 条 件 为 True 时 都 采取 相应 措施 
时 ， 适 合 使 用 这 种 方法 。 

下 面 再 来 看 前 面 的 比萨 店 示例 。 如 果 顾 客 点 了 两 种 配料 ,就 需要 确保 在 其 比萨 中 包含 这 些 配料 : 


toppings.py 


@ requested toppings = ['mushrooms', 'extra cheese'] 


@ if 'mushrooms' in requested toppings: 
print("Adding mushrooms.") 

四 if 'pepperoni' in requested toppings: 
print("Adding pepperoni.") 

@ if 'extra cheese' in requested toppings: 
print("Adding extra cheese.") 


print("\nFinished making your pizzal!") 
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我 们 首先 创建 了 一 个 列表 ， 其 中 包含 顾客 点 的 配料 ( 见 @ )。@ 处 的 if 语 句 检 查 顾 客 是 否 点 
了 配料 蘑菇 ( 'mushrooms' ), 如 果 点 了 , 就 打印 一 条 确认 消息 。@ 处 检查 配料 辣 香 肠 ('pepperoni' ) 
的 代码 也 是 一 个 简单 的 jf 语句 ， 而 不 是 elif 或 else 语 句 ; 因此 不 管 前 一 个 测试 是 否 通 过 ， 都 将 进 
行 这 个 测试 。@ 处 的 代码 检查 顾客 是 否 要 求 多 加 芝士 ('extra cheese' ); 不 管 前 两 个 测试 的 结 
如 何 ， 都 会 执行 这 些 代码 。 每 当 这 个 程序 运行 时 ， 都 会 进行 这 三 个 独立 的 测试 。 

在 这 个 示例 中 ， 会 检查 每 个 条 件 ， 因 此 将 在 比萨 中 添加 蘑菇 并 多 加 芝士 : 


Adding mushTooms . 
Adding extra cheese. 


Finished making your pizzal 


如 果 像 下 面 这 样 转 而 使 用 if-elif-else 结 构 ， 代 码 将 不 能 正确 地 运行 ， 因 为 有 一 个 测试 通 
就 会 跳 过 余下 的 测试 : 


广 


I 


requested toppings = ['mushrooms', 'extra cheese'] 


if 'mushrooms' in requested toppings: 
print("Adding mushrooms.") 

elif 'pepperoni' in requested toppings: 
print("Adding pepperoni.") 

elif “extTa cheese' in requested toppings: 
print("Adding extra cheese.") 


print("\nFinished making your pizza!") 
第 一 个 测试 检查 列表 中 是 否 包含 'mushrooms' ， 它 通过 了 ， 因 此 将 在 比萨 中 添加 蘑菇 。 然 而 ， 


Python 将 路 过 if-elif-else 结 构 中 余下 的 测试 ， 不 再 检查 列表 中 是 否 包 含 "extra cheese' 和 
'pepperoni' 。 其 结果 是 ， 将 添加 顾客 点 的 第 一 种 配料 ， 但 不 会 添加 其 他 的 配料 : 


Adding mushTooms . 


Finished making your pizzal 


总 之 ， 如 果 你 只 想 执 行 一 个 代码 块 ， 就 使 用 if-elif-else 结 构 ; 如 果 要 运行 多 个 代码 块 ， 就 
使 用 一 系列 独立 的 if 语 句 。 


动手 试 一 斌 
S-3 外 星人 颜色 机: 假设 在 游戏 中 刚 射 杀 了 一 个 外 星人 ， 请 创建 一 个 名 为 


alien color 的 变量 ， 并 将 其 设置 为 'green'、'yellow' 或 'red'。 
口 编写 一 条 if 语句 ， 检 查 外 星人 是 否 是 绿色 的 ; 如 果 是 ， 就 打印 一 条 消息 ， 指 出 
玩家 获得 了 5 个 点 。 
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口 编写 这 个 程序 的 两 个 版 本 ， 在 一 个 版 本 中 上 述 测试 通过 了 ， 而 在 另 一 个 版 本 中 

未 通过 (未 通过 测试 时 没有 输出 )。 
S-4 外 星人 颜色 二: 像 练 习 5-3 那样 设置 外 星人 的 颜色 ， 并 编写 一 个 if-else 结构 。 
口 如 果 外 星人 是 绿色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 因 射 杀 该 外 星人 获得 了 5 个 
点 oO 
口 如 果 外 星人 不 是 绿色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 获得 了 10 个 点 。 
口 编写 这 个 程序 的 两 个 版 本 ， 在 一 个 版 本 中 执行 if 代码 块 ， 而 在 另 一 个 版 本 中 执 

行 else 代码 块 。 

5-5 外 星人 颜色 好: 将 练习 5-4 中 的 if-else 结构 改 为 if-elif-else 结构 。 

口 如 果 外 星人 是 绿色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 获得 了 5 个 点 。 

口 如 果 外 星人 是 黄色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 获得 了 10 个 点 。 

口 如 果 外 星人 是 红色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 获得 了 15 个 点 。 

口 编写 这 个 程序 的 三 个 版 本 ， 它 们 分 别 在 外 星人 为 绿色 、 黄 色 和 红色 时 打印 一 条 

消息 。 

S-6 人生 的 不 同 阶段 : 设置 变量 age 的 值 , 再 编写 一 个 if-elif-else 结构 , 根据 age 
的 值 判 断 处 于 人 生 的 哪个 阶段 。 

口 如 果 一 个 人 的 年 龄 小 于 2 岁 ， 就 打印 一 条 消息 ， 指 出 他 是 婴儿 。 
口 如 果 一 个 人 的 年 龄 为 2 ( 含 ) ~4 岁 ， 就 打印 一 条 消息 ， 指 出 他 正 踏 员 学 步 。 
口 如 果 一 个 人 的 年 龄 为 4( 含 ) ~13 岁 ， 就 打印 一 条 消息 ， 指 出 他 是 儿童 。 
口 如 果 一 个 人 的 年 龄 为 13 ( 含 ) ~20 岁 ， 就 打印 一 条 消息 ， 指 出 他 是 青少年 。 
口 如 果 一 个 人 的 年 龄 为 20 ( 含 ) ~65 岁 ， 就 打印 一 条 消息 ， 指 出 他 是 成 年 人 。 
口 如 果 一 个 人 的 年 龄 超过 65 ( 含 ) 岁 ， 就 打印 一 条 消息 ， 指 出 他 是 老年 人 。 

S-7 喜欢 的 水 果 : 创建 一 个 列表 ， 其 中 包含 你 喜欢 的 水 果 ， 再 编写 一 系列 独立 的 if 
语句 ， 检 查 列表 中 是 否 包 含 特定 的 水 果 。 

口 将 该 列表 命名 为 favorite fruits， 并 在 其 中 包含 三 种 水 果 。 

口 编 写 5 条 if 语句, 每 条 都 检查 某 种 水 果 是 否 包含 在 列表 中 ,如 果 包 含 在 列表 中 ， 

就 打印 一 条 消息 ， 如 “You really like bananas!”。 


5.4 使 用 if 语句 处 理 列表 


通过 结合 使 用 if 语句 和 列表 ， 可 完成 一 些 有 趣 的 任务 : 对 列表 中 特定 的 值 做 特殊 处 理 ， 高 
效 地 管理 不 断 变 化 的 情形 ， 如 餐馆 是 否 还 有 特定 的 食材 证 明代 码 在 各 种 情形 下 都 将 按 预 期 那 
样 运 行 。 
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5.4.1 检查 特殊 元 素 


本 章 开头 通过 一 个 简单 示例 演示 了 如 何 处 理 特 殊 值 'bmw' 一 一 它 需要 采用 不 同 的 格式 进行 打 
印 。 既 然 你 对 条 件 测试 和 if 语 句 有 了 大 致 的 认识 ， 下 面 来 进一步 研究 如 何 检 查 列表 中 的 特殊 值 ， 
并 对 其 做 合适 的 处 理 。 

继续 使 用 前 面 的 比萨 店 示 例 。 这 家 比萨 店 在 制作 比萨 时 ， 每 添加 一 种 配料 都 打印 一 条 消息 。 
通过 创建 一 个 列表 , 在 其 中 包含 顾客 点 的 配料 , 并 使 用 一 个 循环 来 指出 添加 到 比萨 中 的 配料 ， 可 
以 以 极 高 的 效率 编写 这 样 的 代码 : 


toppings.py | 


requested toppings = ['mushrooms', 'green peppers', 'extra cheese'] 


for requested topping in requested toppings: 
print("Adding " + requested topping + ".") 


print("\nFinished making your pizza!") 


输出 很 简单 ， 因 为 上 述 代码 不 过 是 一 个 简单 的 for 循 环 : 


Adding mushrooms. 
Adding green peppers. 
Adding extra cheese. 


Finished making your pizzal 


然而 ， 如 果 比 萨 店 的 青椒 用 完了 ， 该 如 何 处 理 呢 ? 为 妥善 地 处 理 这 种 情况 ， 可 在 for 循 环 中 
包含 一 条 if 语 句 : 


requested toppings = ['mushrooms', "green peppers', 'extra cheese'] 


for requested topping in requested toppings: 
© if requested topping == 'green peppers': 
print("Sorry, we are out of green peppers right now.") 
@ else: 
print("Adding " + requested topping + ".") 


print("\nFinished making your pizza!") 


这 里 在 比萨 中 添加 每 种 配料 前 都 进行 检查 。@ 处 的 代码 检查 顾客 点 的 是 否 是 青椒 ， 如 果 是 ， 
就 显示 一 条 消息 ， 指 出 不 能 点 青椒 的 原因 。@ 处 的 else 代 码 块 确保 其 他 配料 都 将 添加 到 比萨 中 。 
输出 表明 ， 受 善 地 处 理 了 顾客 点 的 每 种 配料 : 


Adding mushrooms. 
Sorry, we are out of green peppers right now. 
Adding extra cheese. 


Finished making your pizzal 
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5.4.2 ”确定 列表 不 是 空 的 


到 目前 为 止 , 对 于 处 理 的 每 个 列表 都 做 了 一 个 简单 的 假设 , 即 假设 它们 都 至 少 包含 一 个 元 素 。 
我 们 马上 就 要 让 用 户 来 提供 存储 在 列表 中 的 信息 ,因此 不 能 再 假设 循环 运行 时 列表 不 是 空 的 。 有 
鉴于 此 ， 在 运行 for 循 环 前 确定 列表 是 否 为 空 很 重要 。 

下 面 在 制作 比萨 前 检查 顾客 点 的 配料 列表 是 否 为 空 。 如 果 列 表 是 空 的 , 就 向 顾客 确认 他 是 否 
要 点 普通 比萨 ;如果 列表 不 为 空 ， 就 像 前 面 的 示例 那样 制作 比萨 : 


@ requested toppings = [] 


@ if requested toppings: 
for requested topping in requested toppings: 
print("Adding ”+ requested topping + ".") 
print("\nFinished making your pizzal!l") 
四 else: 
print("Are you sure you want a plain pizza?") 

在 这 里 ， 我 们 首先 创建 了 一 个 空 列表 ， 其 中 不 包含 任何 配料 ( 见 @ )。 在 @ 处 我 们 进行 了 简 
单 检查 ， 而 不 是 直接 执行 for 循 环 。 在 if 语句 中 将 列表 名 用 在 条 件 表达 式 中 时 ，Python 将 在 列表 
至 少 包含 一 个 元 素 时 返回 True， 并 在 列表 为 空 时 返回 False。 如 果 requested_toppings 不 为 空 ， 就 
运行 与 前 一 个 示例 相同 的 for 循 环 ; 否则 ， 就 打印 一 条 消息 ， 询 问 顾客 是 否 确实 要 点 不 加 任何 配 
料 的 普通 比 院 〈( 见 目 )。 

在 这 里 ， 这 个 列表 为 空 ， 因 此 输出 如 下 一 一 询问 顾客 是 否 确实 要 点 普通 比萨 : 


Are you sure you want a plain pizza? 


如 果 这 个 列表 不 为 空 ， 将 显示 在 比萨 中 添加 的 各 种 配料 的 输出 。 


5.4.3 ”使 用 多 个 列表 


顾客 的 要 求 往往 五 花 八 门 , 在 比萨 配料 方面 尤其 如 此 。 如 果 顾 客 要 在 比萨 中 添加 炸 暮 条 , 该 
怎么 办 呢 ? 可 使 用 列表 和 if 语 句 来 确定 能 否 满足 顾客 的 要 求 。 

来 看 看 在 制作 比萨 前 如 何 拒绝 怪异 的 配料 要 求 。 下 面 的 示例 定义 了 两 个 列表 , 其 中 第 一 个 列 
表 包 含 比 萨 店 供应 的 配料 ， 而 第 二 个 列表 包含 顾客 点 的 配料 。 这 次 对 于 requested_toppings 中 的 
每 个 元 素 ， 都 检查 它 是 否 是 比萨 店 供应 的 配料 ， 再 决定 是 否 在 比萨 中 添加 它 : 


@ available toppings = ['mushrooms', 'olives', 'green peppers', 
'pepperoni', 'pineapple', 'extra cheese'| 


@ requested toppings = ['mushrooms', 'french fries', 'extra cheese'] 


四 for requested topping in requested toppings: 
4 if requested topping in available toppings: 
print("Adding " + requested topping + ".") 
9 else: 
print("Sorry, we don't have " + requested topping + ".") 
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print("\nFinished making your pizza!") 


在 @ 处 , 我 们 定义 了 一 个 列表 ,其 中 包含 比萨 店 供应 的 配料 。 请 注意 ， 如 果 比 萨 店 供应 的 配 
料 是 固定 的 ， 也 可 使 用 一 个 元 组 来 存储 它们 。 在 @ 处 ,我们 又 创建 了 一 个 列表 ， 其 中 包含 顾客 点 
的 配料 ， 请 注意 那个 不 同 寻 常 的 配料 一 一 'french fries'。 在 人 @ 处 ,我 们 遍历 顾客 点 的 配料 列表 。 
在 这 个 循环 中 ,对 于 顾客 点 的 每 种 配料 ， 我 们 都 检查 它 是 否 包含 在 供应 的 配料 列表 中 ( 见 @ ); 
如 果 答 案 是 肯定 的 ， 就 将 其 加 入 到 比萨 中 ， 否 则 将 运行 else 代 码 块 ( 见 @@ ): 打印 一 条 消息 ， 告 


诉 顾客 不 供应 这 种 配料 。 全 | 
这 些 代码 的 输出 整洁 而 详实 : 


Adding mushrooms. 
Sorry, we don't have french fries. 
Adding extra cheese. 


Finished making your pizzal 


通过 为 数 不 多 的 几 行 代码 ,我 们 高 效 地 处 理 了 一 种 真实 的 情形 ! 


动手 试 一 斌 
5-8 以 特殊 方式 跟 管理 员 打 招呼 : 创建 一 个 至 少 包含 5 个 用 户 名 的 列表 ， 且 其 中 一 
个 用 户 名 为 'admin'。 想 象 你 要 编写 代码 ， 在 每 位 用 户 登 录 网 站 后 都 打印 一 条 问候 消息 。 
遍历 用 户 名 列表 ， 并 向 每 位 用 户 打印 一 条 问候 消息 。 
口 如 果 用 户 名 为 'admin', 就 打印 一 条 特殊 的 问候 消息 ， 如 “Hello admin, would you 
like to see a status report?” 。 
口 否则 ， 打 印 一 条 普通 的 问候 消息 ， 如 “Hello Eric, thank you for logging in again”。 
5-9 处 理 没有 用 户 的 情形 : 在 为 完成 练习 5-8 编写 的 程序 中 ,添加 一 条 if 语句， 检 
查 用 户 名 列表 是 否 为 空 。 
口 如 果 为 空 ， 就 打印 消息 “We need to find some users!”。 
口 删除 列表 中 的 所 有 用 户 名 ， 确 定 将 打印 正确 的 消息 。 
S-10 检查 用 户 名 : 按 下 面 的 说 明 编 写 一 个 程序 ， 模 拟 网 站 确保 每 位 用 户 的 用 户 名 
都 独一无二 的 方式 。 
口 创建 一 个 至 少 包含 5 个 用 户 名 的 列表 ， 并 将 其 命名 为 current_ users。 
口 再 创建 一 个 包含 5 个 用 户 名 的 列表 ， 将 其 命名 为 new users， 并 确保 其 中 有 一 两 
个 用 户 名 也 包含 在 列表 current users 中 。 
口 遍 历 列表 new users， 对 于 其 中 的 每 个 用 户 名 ， 都 检查 它 是 否 已 被 使 用 。 如 果 是 
这 样 ， 就 打印 一 条 消息 ， 指 出 需要 输入 别 的 用 户 名 ; 否则 ， 打 印 一 条 消息 ， 指 
出 这 个 用 户 名 未 被 使 用 。 
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口 确保 比较 时 不 区 分 大 消息 ; 换 和 句 话 说， 如 果 用 户 名 'John' 已 被 使 用 ,应 拒绝 用 户 
424" JO ss 

S-11 序数 : 序数 表示 位 置 ， 如 lst 和 2nd。 大 多 数 序数 都 以 也 结尾 ， 只 有 1、2 和 3 

例外 。 

口 在 一 个 列表 中 存储 数字 1~9。 

口 遍 历 这 个 列表 。 

口 在 循环 中 使 用 一 个 if-elif-else 结构 ， 以 打印 每 个 数字 对 应 的 序数 。 输 出 内 容 
应 为 1st、2nd、3rd、4th、5th、6th、7th、8th 和 9th， 但 每 个 序数 都 独占 一 行 。 


5.5 设置 if 语句 的 格式 


本 章 的 每 个 示例 都 展示 了 良好 的 格式 设置 习惯 。 在 条 件 测试 的 格式 设置 方面 , PEP 8 提供 的 唯一 
是 ， 在 诸如 ==、>= 和 <= 等 比较 运算 符 两 边 各 添加 一 个 空格 ,例如 ，if age < 4: 要 比 if age<4: 好 。 
这 样 的 空格 不 会 影响 Python 对 代码 的 解读 ， 而 只 是 让 代码 阅读 起 来 更 容易 。 


建议 


动手 试 一 斌 
S-12 设置 if 语 句 的 格式 : 审核 你 在 本 章 编 写 的 程序 ， 确 保 正确 地 设置 了 条 件 测试 
的 格式 。 


S-13 自己 的 想法 : 与 刚 拿 起 本 书 时 相 比 ， 现 在 你 是 一 名 能 力 更 强 的 程序 员 了 。 鉴 
于 你 对 如 何在 程序 中 模拟 现实 情形 有 了 更 深入 的 认识 ,你 可 以 考虑 使 用 程序 来 解决 一 
些 问 题 。 随 着 编程 技能 不 断 提高 ， 你 可 能 想 解决 一 些 问题 ， 请 将 这 方面 的 想法 记录 下 
来 。 想 想 你 可 能 想 编 写 的 游戏 、 想 研究 的 数据 集 以 及 想 创建 的 Web 应 用 程序 。 


5.6 小 结 


在 本 章 中 ， 你 学 习 了 如 何 编写 结果 要 么 为 Ture 要 么 为 False 的 条 件 测试 。 你 学 习 了 如 何 编写 
简单 的 if 语 句 、if-else 语 句 和 if-elif-else 结 构 。 在 程序 中 , 你 使 用 了 这 些 结构 来 测试 特定 的 条 
件 ， 以 确定 这 些 条 件 是 否 满足 。 你 学 习 了 如 何在 利用 高 效 的 for 循 环 的 同时 ， 以 不 同 于 其 他 元 素 
的 方式 对 特定 的 列表 元 素 进行 处 理 。 你 还 再 次 学 习 了 Python 就 代码 格式 方面 提出 的 建议 ， 这 可 确 
保 即 便 你 编写 的 程序 越 来 越 复杂 ， 其 代码 依然 易于 阅读 和 理解 。 

在 第 6 章 ， 你 将 学 习 Python 字 典 。 字 典 类 似 于 列表 ， 但 让 你 能 够 将 不 同 的 信息 关联 起 来 。 你 
将 学 习 如 何 创建 和 遍历 字典 ， 以 及 如 何 将 字典 同 列 表 和 if 语句 结合 起 来 使 用 。 学 习 字 典 让 你 能 够 
模拟 更 多 现实 世界 的 情形 。 


第 6 章 


在 本 章 中 ,你 将 学 习 能 够 将 相关 信息 关联 起 来 的 Python 字典 。 你 
将 学 习 如 何 访问 和 修改 字典 中 的 信息 .鉴于 字典 可 存储 的 信息 量 几乎 
不 受 限制 ,， 因此 我 们 会 演示 如 何 遍历 字典 中 的 数据 。 另 外 ,你 还 将 学 
习 存 储 字 典 的 列表 、 存 储 列 表 的 字典 和 存储 字典 的 字典 。 

理解 字典 后 ,你 就 能 够 更 准确 地 为 各 种 真实 物体 建 模 。 你 可 以 创 
建 一 个 表示 人 的 字典 ， 然 后 想 在 其 中 存储 多 少 信息 就 存储 多 少 信息 : 
姓名 、 年 龄 、 地 址 、 职 业 以 及 要 描述 的 任何 方面 。 你 还 能 够 存储 任意 
两 种 相关 的 信息 ,如 一 系列 单词 及 其 含义 , 一 系列 人 名 及 其 喜欢 的 数 
字 ， 以 及 一 系列 山脉 及 其 海拔 等 。 


6.1 一 个 简单 的 字典 


来 看 一 个 游戏 , 其 中 包含 一 些 外 星人 , 这 些 外 星人 的 颜色 和 点 数 各 不 相同 。 下 面 是 一 个 简单 
的 字典 ， 存储 了 有 关 特 定 外 星人 的 信息 : 


alien.py 


alien 0 = {'color': 'green', 'points': 5} 


print(alien of'color']) 
print(alien Oo['points']) 


字典 alien_o 存 储 了 外 星人 的 颜色 和 点 数 。 使 用 两 条 print 语 句 来 访问 并 打印 这 些 信 息 ， 如 
下 所 示 : 


green 
5 
与 大 多 数 编程 概念 一 样 ， 要 熟练 使 用 字典 ， 也 需要 一 段 时 间 的 练习 。 使 用 字典 一 段 时 间 后 ， 


你 就 会 明白 为 何 它 们 能 够 高 效 地 模拟 现实 世界 中 的 情形 。 


在 Python 中 ， 字 典 是 一 系列 键 - 值 对 。 每 个 键 痢 与 一 个 值 相关 联 ， 你 可 以 使 用 键 来 访问 与 之 
相关 联 的 值 。 与 键 相关 联 的 值 可 以 是 数字 、 字 符 串 、 列 表 力 至 字典 。 事 实 上 ， 可 将 任何 Python 对 
象 用 作 字典 中 的 值 。 

在 python 中 ， 字 上 典 用 放 在 花 括号 {} 中 的 一 系列 键 - 值 对 表示 ， 如 前 面 的 示例 所 示 : 


alien 0 = {'color': 'green', 'points': 5} 


键 - 值 对 是 两 个 相关 联 的 值 。 指 定 键 时 ，Python 将 返回 与 之 相关 联 的 值 。 键 和 值 之 间 用 冒号 
分 隔 ， 而 键 - 值 对 之 间 用 逗号 分 隔 。 在 字典 中 ， 你 想 存 储 多 少 个 键 - 值 对 都 可 以 。 
最 简单 的 字典 只 有 一 个 键 - 值 对 ， 如 下 述 修改 后 的 字典 alien_0 所 示 : 


alien 0 = { color': 'green'} 


这 个 字典 只 存储 了 一 项 有 关 alien_0 的 信息 ， 具 体 地 说 是 这 个 外 星人 的 颜色 。 在 这 个 字典 中 ， 
字符 串 'color ' 是 一 个 键 ， 与 之 相关 联 的 值 为 "green'。 
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.2.1 访问 字典 中 的 值 
要 获取 与 键 相关 联 的 值 ， 可 依次 指定 字典 名 和 放 在 方 括 号 内 的 键 ， 如 下 所 示 : 


alien 0 = {'color': 'green'} 
print(alien 0[ 'color']) 


这 将 返回 字典 alien_0 中 与 键 'color ' 相 关联 的 值 : 


green 


字典 中 可 包含 任意 数量 的 键 - 值 对 。 例 如 ， 下 面 是 最 初 的 字典 alien 0， 其 中 包含 两 个 键 - 
值 对 : 


alien 0 = {'color': 'green', 'points': 5} 


现在 ， 你 可 以 访问 外 星人 alien_0 的 颜色 和 点 数 。 如 果 玩 家 射 杀 了 这 个 外 星人 ， 你 就 可 以 使 
用 下 面 的 代码 来 确定 玩家 应 获得 多 少 个 点 : 


alien 0 = {'color': 'green', 'points': 5} 


@ new points = alien 0['points '] 
@ print("You just earned " + str(new points) + " points!") 


上 述 代 码 首先 定义 了 一 个 字典 ， 然 后 从 这 个 字典 中 获取 与 键 'points' 相 关联 的 值 ( 见 @ )， 
并 将 这 个 值 存储 在 变量 new_points 中 。 接 下 来 ， 将 这 个 整数 转换 为 字符 串 ， 并 打印 一 条 消息 ， 指 
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出 玩家 获得 了 多 少 个 点 ( 见 @ ): 


You just earned 5 points! 


如 果 你 在 有 外 星人 被 射 杀 时 都 运行 这 段 代码 ， 就 会 获取 该 外 星人 的 点 数 。 
6.2.2 添加 键 - 值 对 


字典 是 一 种 动态 结构 ， 可 随时 在 其 中 添加 键 - 值 对。 要 添加 键 - 值 对 ， 可 依次 指定 字典 名 、 用 
方 括号 括 起 的 键 和 相关 联 的 值 。 

下 面 在 字典 alien_0 中 添加 两 项 信息 : 外 星人 的 x 坐 标 和 ?坐标 ， 让 我 们 能 够 在 屏幕 的 特定 位 
置 显 示 该 外 星人 。 我 们 将 这 个 外 星人 放 在 屏幕 左边 缘 ， 且 离 屏幕 上 边缘 25 像 素 的 地 方 。 由 于 屏幕 
坐标 系 的 原点 通常 为 左上 角 ， 因 此 要 将 该 外 星人 放 在 屏幕 左边 缘 , 可 将 x 坐标 设置 为 0; 要 将 该 外 
星人 放 在 离 屏幕 顶部 25 像 素 的 地 方 ， 可 将 y 坐 标 设 置 为 25， 如 下 所 示 : 


alien 0 = {'color': 'green', 'points': 5} 
print(alien 0) 


@ alien oO['x position '] 
@ alien 0['y position '] 
print(alien 0) 


= 0 
= 2 
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我 们 首先 定义 了 前 面 一 直 在 使 用 的 字典 , 然后 打印 这 个 字典, 以 显示 其 信息 快照 。 在 @ 处 ， 
我 们 在 这 个 字典 中 新 增 了 一 个 键 - 值 对 ， 其 中 的 键 为 'x_position' ， 而 值 为 0o。 在 @ 处 ,我 们 重 
复 这 样 的 操作 ， 但 使 用 的 键 为 'y_position' 。 打 印 修改 后 的 字典 时 ， 将 看 到 这 两 个 新 增 的 键 - 
值 对 : 


{'color': 'green', 'points': 5} 
{'color': 'green', 'points': 5, 'y position': 25, 'x_ position': 0} 


这 个 字典 的 最 终 版 本 包含 四 个 键 - 值 对 ， 其 中 原来 的 两 个 指定 外 星人 的 颜色 和 点 数 ， 而 新 增 
的 两 个 指定 位 置 。 注意 , 键 - 值 对 的 排列 顺序 与 添加 顺序 不 同 。 Python 不 关心 键 - 值 对 的 添加 顺序 ， 
而 只 关心 键 和 值 之 间 的 关联 关系 。 


6.2.3 先 创 建 一 个 空 字典 


有 时 候 ， 在 空 字典 中 添加 键 - 值 对 是 为 了 方便 ， 而 有 时 候 必 须 这 样 做 。 为 此 ， 可 先 使 用 一 对 
空 的 花 括号 定义 一 个 字典 ， 再 分 行 添 加 各 个 键 - 值 对 。 例 如 ， 下 例 演示 了 如 何以 这 种 方式 创建 字 
典 alien 0: 


alien 0 = {} 


alien 0O['color'] = 'green' 
alien 0['points'] = 5 


A 
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字 


print(alien 0) 


这 里 首先 定义 了 空 字 典 alien 0， 再 在 其 中 添加 颜色 和 点 数 ， 得 到 前 述 示例 一 直 在 使 用 的 
字典 : 


{ color ' : 'gre 


en', 'points': 5} 


使 用 字典 来 存储 用 户 提供 的 数据 或 在 编写 能 自动 生成 大 量 键 - 值 对 的 代码 时 ， 通 常 都 需要 先 


定义 一 个 空 字典 。 


6.2.4 修改 字典 


中 的 值 


要 修改 字典 中 的 值 , 可 依次 指定 字典 名 、 用 方 括号 括 起 的 键 以 及 与 该 键 相关 联 的 新 值 。 例 如 ， 


假设 随 着 游戏 的 进行 ， 需 要 将 一 个 外 星人 从 绿色 改 为 黄 


直人 色 ， 


alien 0 = {'co 
print("The ali 


alien 0[ "color 


print("The alien is now " 


lor': 'green'} 
en is " + alien O['color'] + 


a 


'] = 'yellow' 
+ alien 0[ "color'] + 


wy) 


我 们 首先 定义 了 一 个 表示 外 星人 alien_0 的 字典 , 其 中 只 包 


来 ,我 们 将 与 键 ' 
了 黄色 : 


含 这 个 外 星人 的 颜色 。 接 下 
这 个 外 星人 确实 从 绿色 变 成 


color ' 相 关联 的 值 改 为 "yellow' 。 输 出 表明 ， 


The alien is green. 
The alien is now yellow. 


来 看 一 个 更 有 趣 的 例子 : 对 一 


个 全 


个 能 够 以 不 同 速度 移动 的 外 星人 的 位 置 进行 跟踪 。 为 此 , 我们 


将 存储 该 外 星人 的 当前 速度 ， 并 据 此 确定 该 外 星人 将 向 右 移 动 多 远 : 


ali 
pri 


en 0 = {'x position': 0, 'y position': 25, 'speed': 'medium'} 
nt("Original x-position: " 


+ str(alien Of['x position' ])) 


# 向 右 移动 外 星人 


# 据 外 星人 当前 速度 决定 将 其 移动 多 远 
@ if alien of'speed'] == 'slow': 
x_increment = 1 
elif alien of'speed'] == "medium': 
x_increment = 2 
else: 
# 这 个 外 星人 的 速度 一 定 很 快 
x_increment = 3 
# 新 位 置 等 于 老 位 置 加 上 增 量 
@ alien oO['x position'] = alien O['x position'] + x increment 
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print("New x-position: " + str(alien 0O['x position'])) 


我 们 首先 定义 了 一 个 外 星人 ， 其 中 包含 初始 的 x 坐标 和 y 和 坐标 ， 还 有 速度 'medium' 。 出 于 简化 
考虑 ， 我 们 省 略 了 颜色 和 点 数 ， 但 即便 包含 这 些 键 - 值 对 ， 这 个 示例 的 工作 原理 也 不 会 有 任何 变 
化 。 我 们 还 打印 了 x_position 的 初始 值 ， 旨 在 让 用 户 知道 这 个 外 星人 向 右 移动 了 多 远 。 

在 @ 人 处 ,使 用 了 一 个 if-elif-else 结 构 来 确定 外 星人 应 向 右 移动 多 远 ， 并 将 这 个 值 存储 在 变 
量 x_increment 中 。 如 果 外 星人 的 速度 为 'slow' ， 它 将 向 右 移动 一 个 单位 ; 如 果 速 度 为 'medium'， 
将 向 右 移 动 两 个 单位 ; 如 果 为 'fast' ， 将 向 右 移动 三 个 单位 。 确 定 移动 量 后 ， 将 其 与 x_position 
的 当前 值 相 加 ( 见 @ )， 再 将 结果 关联 到 字典 中 的 键 x_position。 

由 于 这 是 一 个 速度 中 等 的 外 星人 ， 因 此 其 位 置 将 向 右 移动 两 个 单位 : 


Original x-position: 0 
New x-position: 2 


这 种 技术 很 棒 : 通过 修改 外 星人 字典 中 的 值 ， 可 改变 外 星人 的 行为 。 例 如 ,要 将 这 个 速度 中 
等 的 外 星人 变 成 速度 很 快 的 外 星人 ， 可 添加 如 下 代码 行 : 


alien 0['speed'] = fast 


这 样 ， 再 次 运行 这 些 代 码 时 ， 其 中 的 if-elif-else 结 构 将 把 一 个 更 大 的 值 赋 给 变量 
x_increment。 
6.2.5 ”删除 键 - 值 对 


对 于 字典 中 不 再 需要 的 信息 ， 可 使 用 de1 语 名 将 相应 的 键 - 值 对 彻底 删除 。 使 用 de1 语 句 时 ， 
必须 指定 字典 名 和 要 删除 的 键 。 
例如 ， 下 面 的 代码 从 字典 alien_0 中 删除 键 'points ' 及 其 值 : 


alien 0 = { color': green'， 'points': 5} 
print(alien 0) 


@ del alien 0['points '] 
print(alien 0) 


加 处 的 代码 行 让 Python 将 键 'points' 从 字典 alien_0 中 删除 ， 同 时 删除 与 这 个 键 相 关联 的 值 。 
输出 表明 ， 键 'points' 及 其 值 5 已 从 字典 中 删除 ,但 其 他 键 - 值 对 未 受 影响 : 


{'color': 'green', 'points': 5} 
{'color': 'green'} 


注意 ”删除 的 键 - 值 对 永远 消失 了 。 


A 
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6.2.6 ”由 类 似 对 象 组 成 的 字典 


在 前 面 的 示例 中 , 字典 存储 的 是 一 个 对 象 ( 游戏 中 的 一 个 外 星人 ) 的 多 种 信息 , 但 你 也 可 以 
使 用 字典 来 存储 众多 对 象 的 同一 种 信息 。 例如, 假设 你 要 调查 很 多 人 , 询问 他 们 最 喜欢 的 编程 语 


NE 


言 ， 可 使 用 一 个 字典 来 存储 这 种 简单 调查 的 结果 ， 如 下 所 示 : 


favorite languages = { 
'jen': 'python', 
'sarah': 'c', 
‘edward': 'ruby', 
'phil': 'python', 
i. 


正如 你 看 到 的 ,我 们 将 一 个 较 大 的 字典 放 在 了 多 行 中 。 其 中 每 个 键 都 是 一 个 被 调查 者 的 名 字 ， 
而 每 个 值 都 是 被 调查 者 喜欢 的 语言 。 确 定 需要 使 用 多 行 来 定义 字典 时 , 在 输入 左 花 括号 后 按 回 车 
键 ， 再 在 下 一 行 缩 进 四 个 空格 ， 指 定 第 一 个 键 - 值 对 ， 并 在 它 后 面 加 上 一 个 逗号 。 此 后 你 再 次 按 
回 车 键 时 ， 文 本 编辑 器 将 自动 缩 进 后 续 键 - 值 对 ， 且 缩 进 量 与 第 一 个 键 - 值 对 相同 。 

定义 好 字典 后 ， 在 最 后 一 个 键 - 值 对 的 下 一 行 添加 一 个 右 花 括号 ， 并 缩 进 四 个 空格 ,使 其 与 
字典 中 的 键 对 齐 。 另 外 一 种 不 错 的 做 法 是 在 最 后 一 个 键 - 值 对 后 面 也 加 上 逗号 ， 为 以 后 在 下 一 行 
添加 键 - 值 对 做 好 准备 。 


注意 对 于 较 长 的 列表 和 字典 ， 大 多 数 编辑 器 都 有 以 类 似 方 式 设置 其 格式 的 功能 。 对 于 较 长 的 
字典 ， 还 有 其 他 一 些 可 行 的 格式 设置 方式 ， 因 此 在 你 的 编辑 器 或 其 他 源 代码 中 ， 你 可 能 
会 看 到 稍微 不 同 的 格式 设置 方式 。 


给 定 被 调查 者 的 名 字 ， 可 使 用 这 个 字典 轻松 地 获悉 他 喜欢 的 语言 : 


favorite_ languages.py 


favorite languages = { 


'jen': 'python', 
“Sarah > '€", 

‘edward': “Tuby ， 
"phil : "python ， 


上 


@ print("Sarah's favorite language is ”+ 
@ favorite languages['sarah'].title() + 
【3) i!) 


为 获悉 Sarah 喜 欢 的 语言 ， 我 们 使 用 如 下 代码 : 


favorite languages[ "sarah '] 


在 print 语 句 中 ， 我 们 使 用 了 这 种 语法 〈 见 @ ); 输出 指出 了 Sarah 喜 欢 的 语言 : 


Sarah's favorite language is C. 


这 个 示例 还 演示 了 如 何 将 较 长 的 print 请 句 分 成 多 行 。 单 词 print 比 大 多 数字 典 名 都 短 ， 因 此 
让 输出 的 第 一 部 分 紧 跟 在 左 括号 后 面 是 合理 的 ( 见 @ )。 请 选择 在 合适 的 地 方 拆 分 要 打印 的 内 容 ， 
并 在 第 一 行 末尾 ( 见 @ ) 加 上 一 个 拼接 运算 符 (+)。 按 回 车 键 进入 print 请 句 的 后 续 各 行 ， 并 使 
用 Tab 键 将 它们 对 齐 并 缩 进 一 级 。 指 定 要 打印 的 所 有 内 容 后 ,在 print 语 句 的 最 后 一 行 末尾 加 上 厂 
括号 ( 见 @ )。 


动手 试 一 斌 


6-1 人 : 使 用 一 个 字典 来 存储 一 个 熟人 的 信息 ， 包 括 名 、 姓 、 年 龄 和 居住 的 城市 。 
该 字典 应 包含 键 first name、last name、age 和 city。 将 存储 在 该 字典 中 的 每 项 信息 都 
打印 出 来 。 

6-2 喜欢 的 数字 : 使 用 一 个 字典 来 存储 一 些 人 喜欢 的 数字 。 请 想 出 5 个 人 的 名 字 ， 
并 将 这 些 名 字 用 作 字 典 中 的 键 ; 想 出 每 个 人 喜欢 的 一 个 数字 ,并 将 这 些 数字 作为 值 存储 
在 字典 中 。 打 印 每 个 人 的 名 字 和 喜欢 的 数字 。 为 让 这 个 程序 更 有 趣 ， 通过 询问 朋友 确保 


数据 是 真实 的 。 
6-3 词汇 表 : Python 字典 可 用 于 模拟 现实 生活 中 的 字典 ,但 为 避免 混淆 ， 我 们 将 后 
者 称 为 词汇 表 。 
口 想 出 你 在 前 面 学 过 的 5 个 编程 词汇 ， 将 它们 用 作词 汇 表 中 的 键 ， 并 将 它们 的 含 
义 作 为 值 存 储 在 词汇 表 中 。 
口 以 整洁 的 方式 打印 每 个 词汇 及 其 含义 。 为 此 ， 你 可 以 先 打印 词汇 ， 在 它 后 面 加 
上 一 个 冒号 ， 再 打印 词汇 的 含义 ; 也 可 在 一 行 打 印 词汇 ， 再 使 用 换行 符 ( \n ) 
插入 一 个 空 行 ， 然 后 在 下 一 行 以 缩 进 的 方式 打印 词汇 的 含义 。 


6.3 遍历 字典 


一 个 Python 字典 可 能 只 包含 几 个 键 - 值 对 ， 也 可 能 包含 数 百 万 个 键 - 值 对 。 鉴 于 字典 可 能 包含 
大 量 的 数据 ，Python 支 持 对 字典 遍历 。 字 上 典 可 用 于 以 各 种 方式 存储 信息 ， 因 此 有 多 种 遍历 字典 的 
方式 : 可 遍历 字典 的 所 有 键 - 值 对 、 键 或 值 。 


6.3.1 遍历 所 有 的 键 - 值 对 


探索 各 种 遍历 方法 前 ， 先 来 看 一 个 新 字典 ， 它 用 于 存储 有 关 网 站 用 户 的 信息 。 下 面 的 字典 存 
储 一 名 用 户 的 用 户 名 、 名 和 姓 : 
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user 0 = { 
'username': 'efermi', 
‘first': 'enrico', 
"last': 'fermi', 


} 


利用 本 章 前 面 介绍 过 的 知识 ,可 访问 user_0 的 任何 一 项 信息 , 但 如 果 要 获悉 该 用 户 字 典 中 的 
所 有 信息 ， 该 怎么 办 呢 ? 可 以 使 用 一 个 for 循 环 来 遍历 这 个 字典 : 


USer.Py 

user 0 = { 
'username': 'efermi', 
'first': 'enrico', 
'last': 'fermi', 


个 
J 


@ for key, value in user 0.items(): 
@ print("\nKey: " + key) 
(3 print("Value: " + value) 


如 @ 所 示 , 要 编写 用 于 遍历 字典 的 for 循 环 , 可 声明 两 个 变量 , 用 于 存储 键 - 值 对 中 的 键 和 值 。 
对 于 这 两 个 变量 ， 可 使 用 任何 名 称 。 下 面 的 代码 使 用 了 简单 的 变量 名 ， 这 完全 可 行 : 


for k, v in user 0.items() 


for 语 句 的 第 二 部 分 包含 字典 名 和 方法 items() ( 见 @ )， 它 返回 一 个 键 - 值 对 列表 。 接 下 来 ， 
for 循 环 依次 将 每 个 键 - 值 对 存储 到 指定 的 两 个 变量 中 。 在 前 面 的 示例 中 , 我 们 使 用 这 两 个 变量 3 
打印 每 个 键 ( 见 @ ) 及 其 相关 联 的 值 ( 见 @ )。 第 一 条 print 语 句 中 的 "\n" 确 保 在 输出 每 个 键 - 值 对 
前 都 插入 一 个 空 行 : 


Key: last 
Value: fermi 


Key: first 
Value: enrico 


Key: username 
Value: efermi 


注意 ， 即 便 遍 历 字 典 时 ， 键 - 值 对 的 返回 顺序 也 与 存储 顺序 不 同 。Python 不 关心 键 - 值 对 的 存 
储 顺序 ， 而 只 跟踪 键 和 值 之 间 的 关联 关系 。 

在 6.2.6 节 的 示例 favorite_ languages.py 中 ， 字 典 存储 的 是 不 同人 的 同一 种 信息 ; 对 于 类 似 这 
样 的 字典 ,遍历 所 有 的 键 一 值 对 很 合适 。 如 果 遍 历 字 典 favorite languages， 将 得 到 其 中 每 个 人 
的 姓名 和 喜欢 的 编程 语言 。 由 于 其 中 的 键 都 是 人 名 ， 而 值 都 是 语言 ， 因 此 我 们 在 循环 中 使 用 变量 
name 和 language， 而 不 是 key 和 value， 这 让 人 更 容易 明白 循环 的 作用 : 


favorite_languages.py 


favorite languages = { 


'jen': 'python', 
ssarah MCs 
‘edward': 'ruby', 


'phil': 'python', 


@ for name, language in favorite languages.items(): 
@ print(name.title() + "'s favorite language is ”+ 
language.title() + ".") 


四 处 的 代码 让 Python 遍历 字典 中 的 每 个 键 - 值 对 , 并 将 键 存储 在 变量 name 中 , 而 将 值 存储 在 变 
量 language 中 。 这 些 描述 性 名 称 能 够 让 人 非常 轻松 地 明白 print 语 句 〈 见 @@ ) 是 做 什么 的 。 
仅 使 用 几 行 代码 ， 我 们 就 将 全 部 调查 结果 显示 出 来 了 : 


Jen's favorite language is Python . 
Sarah's favorite language is C. 

Phil's favorite language is Python. 
Edward's favorite language is Ruby. 


即便 字典 存储 的 是 上 千 乃 至 上 百 万 人 的 调查 结果 ， 这 种 循环 也 管用 
6.3.2 ”遍历 字典 中 的 所 有 和 键 


在 不 需要 使 用 字典 中 的 值 时 ， 方 法 keys() 很 有 用 。 下 面 来 遍历 字典 favorite languages， 并 
将 每 个 被 调查 者 的 名 字 都 打印 出 来 : 


O 


favorite languages = { 


'jen': 'python', 
'sarah': 'c', 
‘edward': 'ruby', 


'phil': 'python', 


@ for name in favorite languages.keys(): 
print(name.title()) 


四 处 的 代码 行 让 Python 提取 字典 favorite languages 中 的 所 有 键 ， 并 依次 将 它们 存储 到 变量 
name 中 。 输 出 列 出 了 每 个 被 调查 者 的 名 字 : 


Jen 
Sarah 
Phil 
Edward 
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遍历 字典 时 ， 会 默认 遍历 所 有 的 键 ， 因 此 ， 如 果 将 上 述 代 码 中 的 for name in favorite 
languages.keys() :替换 为 for name in favorite languages:， 输 出 将 不 变 。 

如 果 显 式 地 使 用 方法 keys() 可 让 代码 更 容易 理解 ， 你 可 以 选择 这 样 做 ， 但 如 果 你 愿意 ， 也 可 
省 略 它 。 

在 这 种 循环 中 ,可 使 用 当前 键 来 访问 与 之 相关 联 的 值 。 下 面 来 打印 两 条 消息 ,指出 两 位 朋友 
喜欢 的 语言 。 我 们 像 前 面 一 样 遍 历 字典 中 的 名 字 , 但 在 名 字 为 指定 朋友 的 名 字 时 , 打印 一 条 消息 ， 


章 出 其 喜欢 的 语言 : 


favorite languages = { 
'jen': “python ， 


Sarah > C- ， 
‘edward': “Tuby ， 
phil': “python ， 


} 
@ friends = ['phil', 'sarah'] 
for name in favorite languages.keys(): 
print(name.title()) 


2 if name in friends: 
print("” Hi " + name.title() + 
", I see your favorite language is ”+ 
@ favorite languages[name].title() + "!") 


在 @ 处 ,我们 创建 了 一 个 列表 ， 其 中 包含 我 们 要 通过 打印 消息 ， 指 出 其 喜欢 的 语言 的 朋友 。 
在 循环 中 ， 我 们 打印 每 个 人 的 名 字 ， 并 检查 当前 的 名 字 是 否 在 列表 friends 中 ( 见 @ )。 如 果 在 列 
表 中 ,就 打印 一 句 特殊 的 问候 语 ， 其 中 包含 这 位 朋友 喜欢 的 语言 。 为 访问 喜欢 的 语言 ,我们 使 用 
了 字典 名 ， 并 将 变量 name 的 当前 值 作为 键 ( 见 @ )。 每 个 人 的 名 字 都 会 被 打印 ， 但 只 对 朋友 打印 
特殊 消息 : 

Edward 

Phil 

Hi Phil, I see your favorite language is Python! 

Sarah 


Hi Sarah, I see your favorite language is C! 
Jen 


你 还 可 以 使 用 keys() 确 定 某 个 人 是 否 接 受 了 调查 。 下 面 的 代码 确定 Erin 是 否 接 受 了 调查 : 


favorite languages = { 


'jen': 'python', 
"sarah': 'c', 
‘edward': 'ruby', 
"phil : 'python', 


} 


@ if 'erin' not in favorite languages.keys() 


print("Erin, please take our poll!") 


方法 keys() 并 非 只 能 用 于 遍历 ; 实际 上 ， 它 返回 一 个 列表 ， 其 中 包含 字典 中 的 所 有 键 ， 因 此 
@ 人 处 的 代码 行 只 是 核实 'erin' 是 否 包含 在 这 个 列表 中 。 由 于 她 并 不 包含 在 这 个 列表 中 ， 因 此 打印 
一 条 消息 ， 邀 请 她 参加 调查 


Erin, please take our poll! 


6.3.3” 按 顺序 遍历 字典 中 的 所 有 键 


字典 总 是 明确 地 记录 键 和 值 之 间 的 关联 关系 ,但 获取 字 肉 的 元 素 时 ,获取 顺序 是 不 可 预测 的 。 

这 不 是 问题 ， 因 为 通常 你 想 要 的 只 是 获取 与 键 相 关联 的 正确 的 值 。 6 
要 以 特定 的 顺序 返回 元 素 ， 一 种 办 法 是 在 for 循 环 中 对 返回 的 键 进行 排序 。 为 此 ， 可 使 用 函 

数 sorted() 来 获得 按 特定 顺序 排列 的 键 列表 的 副本 : 


favorite languages = { 

'jen': 'python', 
'sarah': 'c', 
'edward': 'ruby', 
'phil': 'python', 
} 


for name in sorted(favorite languages.keys()): 
print(name.title() + ", thank you for taking the poll.") 


这 条 for 语 名 类似 于 其 他 for 语 句 ， 但 对 方法 dictionary.keys() 的 结果 调用 了 函数 sorted()。 
这 让 Python 列 出 字典 中 的 所 有 键 ， 并 在 遍历 前 对 这 个 列表 进行 排序 。 输 出 表明 ， 按 顺序 显示 了 所 
有 被 调查 者 的 名 字 : 

Edward, thank you for taking the poll. 

Jen, thank you for taking the poll. 


Phil, thank you for taking the poll. 
Sarah, thank you for taking the poll. 


6.3.4 ”遍历 字典 中 的 所 有 值 

如 果 你 感 兴趣 的 主要 是 字典 包含 的 值 ， 可 使 用 方法 values()， 它 返回 一 个 值 列表 ， 而 不 包含 
任何 键 。 例 如 ， 如 果 我 们 想 获得 一 个 这 样 的 列表 ， 即 其 中 只 包含 被 调查 者 选择 的 各 种 语言 ， 而 不 
包含 被 调查 者 的 名 字 ， 可 以 这 样 做 : 


favorite languages = { 


'jen': 'python', 
“sara CE 
‘edward': 'ruby', 


'phil': "python ， 


print("The following languages have been mentioned:") 
for language in favorite languages.values(): 
print(language.title()) 


这 条 for 语 句 提取 字典 中 的 每 个 值 ， 并 将 它们 依次 存储 到 变量 language 中 。 通 过 打印 这 些 值 ， 
得 


就 获得 了 一 个 列表 ， 其 中 包含 被 调查 者 选择 的 各 种 语言 : 
The following languages have been mentioned: 
Python 
GC 
Python 
Ruby 


这 种 做 法 提取 字典 中 所 有 的 值 ， 而 没有 考虑 是 否 重 复 。 涉 及 的 值 很 少时 ， 这 也 许 不 是 问题 ， 
但 如 果 被 调查 者 很 多 ， 最 终 的 列表 可 能 包含 大 量 的 重复 项 。 为 剔除 重复 项 ， 可 使 用 集合 〈set )。 
集合 类 似 于 列表 ， 但 每 个 元 素 都 必须 是 独一无二 的 : 


favorite languages = { 


'jen': 'python', 
"saral s. Cs 
‘edward': 'ruby', 
'phil': 'python', 
: 


} 


print("The following languages have been mentioned:") 
@ for language in set(favorite languages.values()) 


print(language.title()) 


通过 对 包含 重复 元 素 的 列表 调用 set() ， 可 让 Python 找 出 列表 中 独一无二 的 元 素 ， 并 使 用 这 
些 元 素来 创建 一 个 集合 。 在 @ 处 , 我 们 使 用 了 set() 来 提取 favorite languages.values() 中 不 同 的 
语言 。 


结果 是 一 个 不 重复 的 列表 ， 其 中 列 出 了 被 调查 者 提 及 的 所 有 语言 : 


The following languages have been mentioned: 
Python 

CE 

Ruby 


随 着 你 更 深入 地 学 习 Python， 经 常会 发 现 它 内 置 的 功能 可 帮助 你 以 希望 的 方式 处 理 数 据 。 
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6-4 词汇 表 2: 既然 你 知道 了 如 何 遍 历 字 典 ， 现 在 请 整理 你 为 完成 练习 6-3 而 编写 
的 代码 ,将 其 中 的 一 系列 print 语句 替换 为 一 个 遍历 字典 中 的 键 和 值 的 循环 。 确 定 该 循 
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环 正确 无 误 后， 再 在 词汇 表 中 添加 5 个 Python 术语 。 当 你 再 次 运行 这 个 程序 时 ， 这 些 
新 术语 及 其 含义 将 自动 包含 在 输出 中 。 
6-5 河流 : 创建 一 个 字典 ， 在 其 中 存储 三 条 大 河流 及 其 流 经 的 国家 。 其 中 一 个 键 - 
值 对 可 能 是 'nile': "egypt'。 
口 使 用 循环 为 每 条 河流 打印 一 条 消息 ， 如 “The Nile runs through Egypt.”。 
口 使 用 循环 将 该 字典 中 每 条 河流 的 名 字 都 打印 出 来 。 
口 使 用 循环 将 该 字典 包含 的 每 个 国家 的 名 字 都 打印 出 来 。 
6-6 调查 : 在 6.3.1 节 编 写 的 程序 favorite languages.py 中 执行 以 下 操作 。 
口 创建 一 个 应 该 会 接受 调查 的 人 员 名 单 ， 其 中 有 些 人 已 包含 在 字典 中 ， 而 其 他 人 
未 包含 在 字典 中 。 
口 遍历 这 个 人 员 名 单 ， 对 于 已 参与 调查 的 人 ， 打 印 一 条 消息 表示 感谢 。 对 于 还 未 
参与 调查 的 人 ， 打 印 一 条 消息 邀请 他 参与 调查 。 


6.4 藤 套 


有 了 时候, 需要 将 一 系列 字典 存储 在 列表 中 ,或 将 列表 作为 值 存储 在 字典 中 ,这 称 为 谋 套 。 你 
可 以 在 列表 中 髋 套 字典 、 在 字典 中 骨 套 列表 甚至 在 字典 中 舱 套 字典 。 正 如 下 面 的 示例 将 演示 的 ， 
机 套 是 一 项 强大 的 功能 。 


6.4.1 字典 列表 

字典 alien 0 包含 一 个 外 星人 的 各 种 信息 ， 但 无 法 存储 第 二 个 外 星人 的 信息 ， 更 别 说 屏幕 上 
全 部 外 星人 的 信息 了 。 如 何 管理 成 群 结 队 的 外 星人 呢 ? 一 种 办 法 是 创建 一 个 外 星人 列表 , 其 中 每 
个 外 星人 都 是 一 个 字典 ,包含 有 关 该 外 星人 的 各 种 信息 。 例 如 , 下 面 的 代码 创建 一 个 包含 三 个 外 
星人 的 列表 : 


aliens.py 


alien 0 = {'color': 'green', 'points': 5} 
alien 1 = {'color': 'yellow', 'points': 10} 
alien 2 = {'color': 'red', 'points': 15} 


@ aliens = [alien 0, alien 1, alien 2] 


for alien in aliens: 
print(alien) 


我 们 首先 创建 了 三 个 字典 ， 其 中 每 个 字典 都 表示 一 个 外 星人 。 在 @ 处 ,我 们 将 这 些 字典 都 放 
到 一 个 名 为 aliens 的 列表 中 。 最 后 ， 我 们 遍历 这 个 列表 ， 并 将 每 个 外 星人 都 打印 出 来 : 
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{'color': 'green', 'points': 5} 

8 p 
{'color': 'yellow', 'points': 10} 
{'color': 'red', 'points': 15} 


更 符合 现实 的 情形 是 , 外 星人 不 止 三 个 , 且 每 个 外 星人 都 是 使 用 代码 自动 生成 的 。 在 下 面 的 
示例 中 ， 我 们 使 用 range() 生 成 了 30 个 外 星人 : 


# 创建 一 个 用 于 存储 外 星人 的 空 列表 


aliens = [] 


# 创建 30 个 绿色 的 外 星人 

for alien number in range(30): 

new alien = {'color': 'green', 'points': 5, 'speed': 'slow'} 
aliens.append(new alien) 


@Q@GOe 


# 显示 前 五 个 外 星人 
@ for alien in aliens[:5]: 
print(alien) 
print("...") 


# 显示 创建 了 多 少 个 外 星人 
@ print("Total number of aliens: "+ str(len(aliens))) 


在 这 个 示例 中 ， 首 先 创 建 了 一 个 空 列表 ， 用 于 存储 接 下 来 将 创建 的 所 有 外 星人 。 在 @ 处 ， 
range() 返 回 一 系列 数字 , 其 唯一 的 用 途 是 告诉 Python 我 们 要 重复 这 个 循环 多 少 次 。 每 次 执行 这 个 
循环 时 ， 都 创建 一 个 外 星人 《 见 @@)， 并 将 其 附加 到 列表 aliens 末 尾 〈 见 日 )。 在 @ 处 ， 使 用 
一 个 切片 来 打印 前 五 个 外 星人 ; 在 @ 处 ， 打 印 列 表 的 长 度 ， 以 证 明确 实 创建 了 30 个 外 星人 : 

{'speed': 'slow', 'color': 'green', 'points': 5} 


党 3 
{'speed': 'slow', 'color': 'green', 'points': 5} 
{'speed': 'slow', 'color': 'green', 'points': 5} 
2 漠 
上 站 


{'speed': 'slow', 'color': 'green', 'points': 5} 
{'speed': 'slow', 'color': 'green', 'points': 5} 


Total number of aliens: 30 


这 些 外 星人 都 具有 相同 的 特征 , 但 在 Python 看 来 ,每 个 外 星人 都 是 独立 的 ， 这 让 我 们 能 够 独 
立地 修改 每 个 外 星人 。 

在 什么 情况 下 需要 处 理 成 群 结 队 的 外 星人 呢 ? 想象 一 下 , 可 能 随 着 游戏 的 进行 , 有 些 外 星人 
会 变色 且 移 动 速度 会 加 快 。 必 要 时 ， 我 们 可 以 使 用 for 循 环 和 if 语句 来 修改 某 些 外 星人 的 颜色 。 
例如 ， 要 将 前 三 个 外 星人 修改 为 黄色 的 、 速 度 为 中 等 且 值 10 个 点 ， 可 以 这 样 做 : 


# 创建 一 个 用 于 存储 外 星人 的 空 列表 
aliens = [| 


# 创建 30 个 绿色 的 外 星人 


for alien number in range (0,30): 
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new alien = {'color': 'green', 'points': 5, 'speed': 'slow'} 
aliens.append(new alien) 
for alien in aliens[0:3]: 
if alien['color'] == 'green': 
alien['color'] = 'yellow' 
alien['speed'] = "medium' 
alien['points'] = 10 
# 显示 前 五 个 外 星人 
for alien in aliens[0:5]: 


print(alien) 
print("...") 


鉴于 我 们 要 修改 前 三 个 外 星人 , 需要 遍历 一 个 只 包含 这 些 外 星人 的 切片 。 当 前 ,所 有 外 星人 
都 是 绿色 的 , 但 情况 并 非 总 是 如 此 ， 因 此 我 们 编写 了 一 条 if 语 句 来 确保 只 修改 绿色 外 星人 。 如 果 


外 星人 是 绿色 的 ， 我 们 就 将 其 颜色 改 为 'yellow' ， 将 其 速度 改 为 'medium' ， 并 将 其 点 数 改 为 10， 
如 下 面 的 输出 所 示 : 
{'speed': 'medium', 'color': 'yellow', 'points': 10} 
{'speed': 'medium', 'color': 'yellow', 'points': 10} 
{'speed': 'medium', 'color': 'yellow', 'points': 10} 
{'speed': 'slow', 'color': 'green', 'points': 5} 
'slow', 'color': 'green', 'points': 5} 


{'speed': 


你 可 以 进一步 扩展 这 个 循环 ,在 其 中 添加 一 个 elif 代 码 块 , 将 黄色 外 星人 改 为 移动 速 
值 15 个 点 的 红色 外 星人 ， 如 下 所 示 ( 这 里 只 列 出 了 循环 ， 而 没有 列 出 整个 程序 ): 


度 快 且 


fo ee in aliens[0:3]: 


f alien['color'] == 'green': 
alien[' color '] = “yellow' 
alien[' speed ' ] = medium' 
alien[ 'points' ] = 10 
elif alien[ "color '] == "yellow': 
alien[ 'color'] = "Ted' 
alien['speed'] = 'fast' 
alien['points'] = 15 
经 常 需要 在 列表 中 包含 大 量 的 字典 ,而 其 中 每 个 字典 都 包含 特定 对 象 的 众多 信息 。 例如 ,你 
可 能 需要 为 网 站 的 每 个 用 户 创 建 一 个 字典 ( 就 像 6.3.1 节 的 user.py 中 那样 )， 并 将 这 些 字典 存储 在 


一 个 名 为 users 的 列表 中 。 在 这 
并 以 相同 的 方式 处 理 其 中 的 每 个 字 


6.4.2 ”在 字典 中 存储 列表 
有 时 候 ， 需 要 将 列表 存储 在 字典 中 ， 而 不 是 将 字典 存储 在 列表 中 。 例 如 ,你 如 何 描述 顾客 点 


， 所 有 字典 的 结构 都 相同 ， 


字典 。 


因此 你 可 以 遍历 这 个 列表 ， 
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的 比萨 呢 ? 如 果 使 用 列表 ， 只 能 存储 要 添加 的 比萨 配料 ; 但 如 果 使 用 字典 ， 就 不 仅 可 在 其 中 包含 
配料 列表 ， 还 可 包含 其 他 有 关 比 萨 的 描述 。 

在 下 面 的 示例 中 , 存储 了 比萨 的 两 方面 信息 : 外 皮 类 型 和 配料 列表 。 其 中 的 配料 列表 是 一 个 
与 键 'toppings' 相 关联 的 值 。 要 访问 该 列表 ， 我 们 使 用 字典 名 和 键 'toppings' ， 就 像 访问 字典 中 
的 其 他 值 一 样 。 这 将 返回 一 个 配料 列表 ， 而 不 是 单个 值 : 


pizza.py 


# 存储 所 点 比萨 的 信息 
@ pizza = { 
‘crust': 'thick', 
'toppings': ['mushrooms', 'extra cheese'], 


# 概述 所 点 的 比萨 
@ print("You ordered a " + pizza['crust'] + "-crust pizza " + 
"with the following toppings:") 


@ for topping in pizzal['toppings']: 
print("\t" + topping) 


我 们 首先 创建 了 一 个 字典 ， 其 中 存储 了 有 关 顾 客 所 点 比萨 的 信息 ( 见 @ )。 在 这 个 字典 中 ， 
一 个 键 是 'crust'， 与 之 相关 联 的 值 是 字符 串 'thick' ; 下 一 个 键 是 'toppings'， 与 之 相关 联 的 值 
是 一 个 列表 ， 其 中 存储 了 顾客 要 求 添加 的 所 有 配料 。 制 作 前 我 们 概述 了 顾客 所 点 的 比萨 ( 见 @ )。 
为 打印 配料 ， 我 们 编写 了 一 个 for 循 环 ( 见 @ )。 为 访问 配料 列表 ， 我 们 使 用 了 键 'toppings'， 这 
样 Python 将 从 字典 中 提取 配料 列表 。 

下 面 的 输出 概述 了 要 制作 的 比萨 : 


You ordered a thick-crust pizza with the following toppings: 
mushrooms 
extra cheese 


每 当 需 要 在 字典 中 将 一 个 键 关联 到 多 个 值 时 , 都 可 以 在 字典 中 恋 套 一 个 列表 。 在 本 章 前 面 有 
关 喜 欢 的 编程 语言 的 示例 中 , 如 果 将 每 个 人 的 回答 都 存储 在 一 个 列表 中 , 被 调查 者 就 可 选择 多 种 
喜欢 的 语言 。 在 这 种 情况 下 ， 当 我 们 遍历 字典 时 ， 与 每 个 被 调查 者 相关 联 的 都 是 一 个 语言 列表 ， 
而 不 是 一 种 语言 ; 因此 ,在 遍历 该 字典 的 for 循 环 中 , 我 们 需要 再 使 用 一 个 for 循 环 来 遍历 与 被 调 
查 者 相关 联 的 语言 列表 : 


favorite_languages.py 


@ favorite languages = { 
"jen : [ python " ， 'ruby'], 
'sarah': ['c'], 
'edward': ['ruby', 'go'], 
'phil': ['python', 'haskell'], 
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@ for name, languages in favorite languages.items() 
print("\n" + name.title() + "'s favorite languages are:") 
8 for language in languages: 
print("\t" + language.title()) 


正如 你 看 到 的 ， 现 在 与 每 个 名 字 相 关联 的 值 都 是 一 个 列表 ( 见 @ )。 请 注意 ， 有 些 人 喜欢 的 
语言 只 有 一 种 ， 而 有 些 人 有 多 种 。 遍 历 字 典 时 ( 见 @ )， 我 们 使 用 了 变量 languages 来 依次 存储 字 
典 中 的 每 个 值 ， 因 为 我 们 知道 这 些 值 都 是 列表 。 在 遍历 字典 的 主 循环 中 ， 我 们 又 使 用 了 一 个 for 
循环 来 遍历 每 个 人 喜欢 的 语言 列表 ( 见 @ )。 现 在 ， 每 个 人 想 列 出 多 少 种 喜欢 的 语言 都 可 以 : 


Jen's favorite languages are: 
Python 
Ruby 


Sarah's favorite languages are: 
C 


Phil's favorite languages are: 
Python 
Haskell 


Edward's favorite languages are: 
Ruby 
Go 


为 进一步 改进 这 个 程序 ， 可 在 遍历 字典 的 for 循 环 开头 添加 一 条 if 语句 ， 通 过 查看 len 
(languages) 的 值 来 确定 当前 的 被 调查 者 喜欢 的 语言 是 否 有 多 种 。 如 果 他 喜欢 的 语言 有 多 种 ， 就 
像 以 前 一 样 显 示 输 出 ; 如 果 只 有 一 种 , 就 相应 修改 输出 的 措辞 , 如 显示 Sarah's favorite language 


1S Co 


~ 


注意 列表 和 字典 的 说 套 层 级 不 应 太 多 。 如 果 赃 套 层 级 比 前 面 的 示例 多 得 多 ,很 可 能 有 更 简单 
的 解决 问题 的 方案 。 


6.4.3 在 字典 中 存储 字典 


可 在 字典 中 舱 套 字典 ， 但 这 样 做 时 ， 代 码 可 能 很 快 复杂 起 来 。 例 如 ， 如 果 有 多 个 网 站 用 户 ， 
每 个 都 有 独特 的 用 户 名 , 可 在 字典 中 将 用 户 名 作为 键 , 然 后 将 每 位 用 户 的 信息 存储 在 一 个 字典 中 ， 
F 将 该 字典 作为 与 用 户 名 相关 联 的 值 。 在 下 面 的 程序 中 ,对 于 每 位 用 户 , 我 们 都 存储 了 其 三 项 信 
息 : 名 、 姓 和 居住 地 ; 为 访问 这 些 信息 , 我 们 遍历 所 有 的 用 户 名 ,并 访问 与 每 个 用 户 名 相关 联 的 
言 息 字典 : 


半 


一 
| 


百 ， 
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many_users.py 


users = { 

'aeinstein': { 
"first': "albert', 
"last': 'einstein', 
‘location': 'princeton’', 


'mcurie': { 

‘first': 'marie', 
"last': 'curie', 
‘location': 'paris', 


}, 
} 
@ for username, user info in users.items(): 
@ print("\nUsername: " + username) 
(3) full name = user info[ 'first'] + " " + user info['last'] 


location = user info['location'] 


@ print("\tFull name: " + full name.title()) 
print("\tLocation: "+ location.title()) 


我 们 首先 定义 了 一 个 名 为 users 的 字典 ， 其 中 包含 两 个 键 : 用 户 名 'aeinstein' 和 'mcurie'; 
与 每 个 键 相关 联 的 值 都 是 一 个 字典 ， 其 中 包含 用 户 的 名 、 姓 和 居住 地 。 在 @ 处 ， 我 们 遍历 字典 
users,， 让 Python 依次 将 每 个 键 存储 在 变量 username 中 , 并 依次 将 与 当前 键 相 关联 的 字典 存储 在 变 
量 user_ info 中。 在 主 循环 内 部 的 四 处 ， 我 们 将 用 户 名 打印 出 来 。 

在 人 @ 处 , 我 们 开始 访问 内 部 的 字典 。 变量 user_ info 包含 用 户 信息 字典 , 而 该 字典 包含 三 个 键 : 
'first' 、'last' 和 'location'; 对 于 每 位 用 户 ， 我 们 都 使 用 这 些 键 来 生成 整洁 的 姓名 和 居住 地 ， 
然后 打印 有 关 用 户 的 简要 信息 ( 见 @ ): 


Username: aeinstein 
Full name: Albert Einstein 
Location: Princeton 


Username: mcurie 
Full name: Marie Curie 
Location: Paris 


了 


请 注意 ， 表 示 每 位 用 户 的 字典 的 结构 都 相同 ,虽然 Python 并 没有 这 样 的 要 求 ， 但 这 使 得 柚 
套 的 字典 处 理 起 来 更 容易 。 倘 若 表 示 每 位 用 户 的 字典 都 包含 不 同 的 键 ，for 循 环 内 部 的 代码 将 
更 复杂 。 


中 
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动手 试 一 斌 

6-7 人 : 在 为 完成 练习 6-1 而 编写 的 程序 中 ， 再 创建 两 个 表示 人 的 字典 ， 然 后 将 这 
三 个 字典 都 存储 在 一 个 名 为 people 的 列表 中 。 遍 历 这 个 列表 ， 将 其 中 每 个 人 的 所 有 信 
息 都 打印 出 来 。 

6-8 宠物 : 创建 多 个 字典 ， 对 于 每 个 字典 ， 都 使 用 一 个 宠物 的 名 称 来 给 它 命名 ; 在 
每 个 字典 中 ， 包 含 宠物 的 类 型 及 其 主人 的 名 字 。 将 这 些 字 典 存 储 在 一 个 名 为 pets 的 列 
表 中 ， 再 遍历 该 列表 ， 并 将 宠物 的 所 有 信息 都 打印 出 来 。 

6-9 喜欢 的 地 方 : 创建 一 个 名 为 favorite places 的 字典 。 在 这 个 字典 中 ， 将 三 个 
人 的 名 字 用 作 键 ; 对 于 其 中 的 每 个 人 ， 都 存储 他 喜欢 的 1~3 个 地 方 。 为 让 这 个 练习 更 有 
趣 些 ,可 让 一 些 朋 友 指 出 他 们 喜欢 的 几 个 地 方 。 人 遍历 这 个 字典 ， 并 将 其 中 每 个 人 的 名 字 
及 其 喜欢 的 地 方 打印 出 来 。 

6-10 喜欢 的 数字 : 修改 为 完成 练习 6-2 而 编写 的 程序 ， 让 每 个 人 都 可 以 有 多 个 喜欢 
的 数字 ， 然 后 将 每 个 人 的 名 字 及 其 喜欢 的 数字 打印 出 来 。 

6-11 城市 : 创建 一 个 名 为 cities 的 字典 ， 其 中 将 三 个 城市 名 用 作 键 ; 对 于 每 座 城 
市 ， 都 创建 一 个 字典 ， 并 在 其 中 包含 该 城市 所 属 的 国家 、 人 口 约 数 以 及 一 个 有 关 该 城市 
的 事实 。 在 表示 每 座 城市 的 字典 中 ， 应 包含 country、population 和 fact 等 键 。 将 每 座 
城市 的 名 字 以 及 有 关 它 们 的 信息 都 打印 出 来 。 

6-12 扩展 : 本 章 的 示例 足够 复杂 ， 可 以 以 很 多 方式 进行 扩展 了 。 请 对 本 章 的 一 个 
示例 进行 扩展 : 添加 键 和 值 、 调 整 程序 要 解决 的 问题 或 改进 输出 的 格式 。 


6.5 小结 


在 本 章 中 , 你 学 习 了 : 如 何 定义 字典 ， 以 及 如 何 使 用 存储 在 字典 中 的 信息 ; 如 何 访问 和 修改 
字典 中 的 元 素 ， 以 及 如 何 遍 历 字 典 中 的 所 有 信息 ; 如 何 遍历 字典 中 所 有 的 键 - 值 对 、 所 有 的 键 和 
所 有 的 值 ; 如 何在 列表 中 藤 套 字典 、 在 字典 中 纵 套 列表 以 及 在 字典 中 和 藤 套 字 典 。 

在 下 一 章 中 ,你 将 学 习 while 循 环 以 及 如 何 从 用 户 那 里 获取 输入 。 这 是 激动 人 心 的 一 章 ， 让 
你 知道 如 何 将 程序 变 成 交互 性 的 一 一 能 够 对 用 户 输入 作出 啊 应 。 


用 户 输入 和 whjile 循 环 


大 多 数 程序 都 旨 在 解决 最 终 用 户 的 问题 ,为 此 通常 需要 从 用 户 那 
里 获取 一 些 信 息 。 例如， 假设 有 人 要 判断 自己 是 否 到 了 投票 的 年 龄 ， 
要 编写 回答 这 个 问题 的 程序 , 就 需要 知道 用 户 的 年 龄 , 这 样 才能 给 出 
答案 。 因 此 ,这 种 程序 需要 让 用 户 输入 其 年 龄 ， 再 将 其 与 投票 年 龄 进 
行 比 较 ， 以 判断 用 户 是 否 到 了 投票 的 年 龄 ， 再 给 出 结果 。 

在 本 章 中 , 你 将 学 习 如 何 接受 用 户 输入 , 让 程序 能 够 对 其 进行 处 
理 。 在 程序 需要 一 个 名 字 时 ,你 需要 提示 用 户 输入 该 名 字 ; 程序 需要 
一 个 名 单 时 ， 你 需要 提示 用 户 输入 一 系列 名 字 。 为 此 ,你 需要 使 用 函 
数 input()。 

你 还 将 学 习 如 何 让 程序 不 断 地 运行 ,让 用 户 能 够 根据 需要 输入 信息 ,并 在 程序 中 使 用 这 
些 信 息 。 为 此 ， 你 需要 使 用 while 循 环 让 程序 不 断 地 运行 ， 直 到 指定 的 条 件 不 满足 为 止 。 

通过 获取 用 户 输 入 并 学 会 控制 程序 的 运行 时 间 ， 可 编写 出 交互 式 程序 。 


7.1 了 通 数 input() 的 工作 原理 


函数 input() 让 程序 暂停 运行 , 等待 用 户 输 入 一 些 文 本 。 获取 用 户 输入 后 ,Python 将 其 存储 在 
一 个 变量 中 ， 以 方便 你 使 用 。 

例如 ， 下 面 的 程序 让 用 户 输入 一 些 文本 ， 表 将 这 些 文本 呈现 给 用 户 : 

parrot.py 


message = input("Tell me something, and I will repeat 让 back to you: ") 
print(message) 


函数 input() 接 受 一 个 参数 : 即 要 向 用 户 显示 的 提示 或 说 明 ， 让 用 户 知道 该 如 何 做 。 在 这 个 
示例 中 ，Python 运 行 第 1 行 代码 时 ， 用 户 将 看 到 提示 Tell me something, and I will repeat it back 
to you:。 程 序 等 竺 用户 输入 ， 并 在 用 户 按 回 车 键 后 继续 运行 。 输 入 存储 在 变量 message 中 ， 接 下 
来 的 print(message) 将 输入 呈现 给 用 户 : 
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Tell me something, and I will repeat it back to you: Hello everyone! 
Hello everyone! 


注意 Sublime Text 不 能 运行 提示 用 户 输入 的 程序 。 你 可 以 使 用 Sublime Text 来 编写 提示 用 户 输入 
的 程序 ， 但 必须 从 终端 运行 它们 。 详 情 请 参阅 1.4 节 。 


7.1.1 编写 清晰 的 程序 


每 当 你 使 用 函数 input() 时 ， 都 应 指定 清晰 而 易于 明白 的 提示 ， 准 确 地 指出 你 希望 用 户 提供 
什么 样 的 信息 一 一 指出 用 户 该 输入 任何 信息 的 提示 都 行 ， 如 下 所 示 : 


greeter.py 


name = input("Please enter your name: ") 
print("Hello, " + name + "!") 


通过 在 提示 末尾 ( 这 里 是 冒号 后 面 ) 包含 一 个 空格 ,可 将 提示 与 用 户 输入 分 开 ， 让 用 户 清楚 
地 知道 其 输入 始 于 何 处 ， 如 下 所 示 : 


Please enter your name: Eric 
Hello, Eric! 


有 时 候 ， 提 示 可 能 超过 一 行 ， 例 如 ， 你 可 能 需要 指出 获取 特定 输入 的 原因 。 在 这 种 情况 下 ， 
可 将 提示 存储 在 一 个 变量 中 , 再 将 该 变量 传递 给 函数 input()。 这 样 , 即便 提示 超过 一 行 , input() 
语句 也 非常 清晰 。 

greeter.py 


prompt = "If you tell us who you are, we can personalize the messages you see." 
prompt += "\nWhat is your first name? " 


name = input(prompt) 
print("\nHello, " + name + "!") 


这 个 示例 演示 了 一 种 创建 多 行 字符 串 的 方式 。 第 1 行将 消息 的 前 半 部 分 存储 在 变量 prompt 中 
在 第 2 行 中 ， 运 算 符 += 在 存储 在 prompt 中 的 字符 串 末 尾 附加 一 个 字符 串 。 
最 终 的 提示 横 跨 两 行 ， 并 在 问号 后 面包 含 一 个 空格 ， 这 也 是 出 于 清晰 考虑 : 


If you tell us who you are, we can personalize the messages you see. 
What is your first name? Eric 


Hello, Eric! 
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7.1.2 ”使 用 int() 来 获取 数值 输入 
使 用 函数 input() 时 , Python 将 用 户 输入 解读 为 字符 串 。 请 看 下 面 让 用 户 输入 其 年 龄 的 解释 器 


>>> age = input("How old are you? ") 
How old are you? 21 

>>> age 

1 


用 户 输入 的 是 数字 21, 但 我 们 请 求 Python 提 供 变 量 age 的 值 时 , 它 返 回 的 是 '21' 一 一 用 户 输入 
的 数值 的 字符 串 表示 。 我 们 怎么 知道 Python 将 输入 解读 成 了 字符 串 呢 ”因为 这 个 数字 用 引号 括 起 
了 。 如 果 我 们 只 想 打印 输入 ,这 一 点 问题 都 没有 ; 但 如 果 你 试图 将 输入 作为 数字 使 用 ， 就 会 引发 


错误 : 


>>> age = input("How old are you? ") 
How old are you? 21 
@ >>> age >= 18 
Traceback (most recent call last): 
File "<stdin>", line 1, in <module> 
@ TypeError: unorderable types: str() >= int() 


你 试图 将 输入 用 于 数值 比较 时 ( 见 @ )，Python 会 引发 错误 ， 因 为 它 无 法 将 字符 串 和 整数 进 
行 比较 : 不 能 将 存储 在 age 中 的 字符 串 '21 "与 数值 18 进 行 比较 ( 见 @ )。 

为 解决 这 个 问题 ， 可 使 用 函数 int()， 它 让 Python 将 输入 视 为 数值 。 函 数 int() 将 数字 的 字符 
串 表示 转换 为 数值 表示 ， 如 下 所 示 : 


>>> age = input("How old are you? ") 
How old are you? 21 
© >>>age = int(age) 

>>> age >= 18 

True 

在 这 个 示例 中 , 我 们 在 提示 时 输入 21 后 , Python 将 这 个 数字 解读 为 字符 串 , 但 随后 int() 将 这 
个 字符 串 转 换 成 了 数值 表示 ( 见 @ )。 这 样 Python 就 能 运行 条 件 测 试 了 : 将 变量 age ( 它 现在 包含 
数值 21 ) 同 18 进 行 比较 ， 看 它 是 否 大 于 或 等 于 18。 测 试 结果 为 True。 

如 何在 实际 程序 中 使 用 函数 int() 呢 ? 请 看 下 面 的 程序 ， 它 判断 一 个 人 是 否 满足 坐 过 山 车 的 
身高 要 求 : 


rollercoaster.py 


height 
height 


= input("How tall are you, in inches? ") 
= int(height) 
if height >= 36: 

print("\nYou're tall enough to ride!") 
else: 
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print("\nYou'11 be able to ride when you're a little older.") 


在 这 个 程序 中 ， 为 何 可 以 将 height 同 36 进 行 比较 呢 ? 因为 在 比较 前 ，height = int(height) 
将 输入 转换 成 了 数值 表示 。 如 果 输 入 的 数字 大 于 或 等 于 36， 我 们 就 告诉 用 户 他 满足 身高 条 件 


How tall are you, in inches? 71 


You're tall enough to ride! 
将 数值 输入 用 于 计算 和 比较 前 ， 务 必 将 其 转换 为 数值 表示 。 
7.1.3 求 模 运 算 符 
处 理 数 值 信息 时 ， 求 模 运 算 符 〈% ) 是 一 个 很 有 用 的 工具 ， 它 将 两 个 数 相 除 并 返回 余数 


>>> 4%3 
1 
>>> 5%3 
2 
>>> 6 %3 
0 
>>>7%3 
4 


求 模 运算 符 不 会 指出 一 个 数 是 男 一 个 数 的 多 少 倍 ， 而 只 指出 余数 是 多 少 。 
如 果 一 个 数 可 被 男 一 个 数 整 除 , 余数 就 为 0，， 因 此 求 模 运算 符 将 返回 0。 你 可 利用 这 一 点 来 判 
类 一 个 数 是 奇数 还 是 偶数 : 


even_or_odd.py 


number = input("Enter a number, and I' 11 tell you if it's even or odd: ") 
number = int(number) 


if number % 2 == 

print("\nThe number "+ str(number) + "is even.") 
else: 

print("\nThe number " + str(number) + " is odd.") 


偶数 都 能 被 2 整除 ， 因 此 对 一 个 数 (numper ) 和 2 执行 求 模 运算 的 结果 为 零 ， 即 number % 2 == 
0， 那 么 这 个 数 就 是 偶数 ;否则 就 是 奇数 。 


Enter a number, and I'1l] tell you if it's even or odd: 42 


The number 42 is even. 
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7.1.4 在 Python 2.7 中 获取 输入 


如 果 你 使 用 的 是 Python 2.7， 应 使 用 函数 raw_input() 来 提示 用 户 输入 。 这 个 函数 与 Python 3 
中 的 input() 一 样 ， 也 将 输入 解读 为 字符 串 。 

Python 2.7 也 包含 函数 input()， 但 它 将 用 户 输入 解读 为 Python 代码 ， 并 尝试 运行 它们 。 因 此 ， 
最 好 的 结果 是 出 现 错误 ， 指 出 Python 不 明白 输入 的 代码 ; 而 最 糟 的 结果 是 ， 将 运行 你 原本 无 意 运 
行 的 代码 。 如 果 你 使 用 的 是 Python 2.7， 请 使 用 raw_input() 而 不 是 input() 来 获取 输入 。 


动手 试 一 斌 
7-1 汽车 租赁 : 编写 一 个 程序 ， 询 问 用 户 要 租赁 什么 样 的 汽车 ， 并 打印 一 条 消息 ， 
如 “Let me see ifIcan findyouaSubaru 。 


7-2 餐馆 订 位 : 编写 一 个 程序 ， 询 问 用 户 有 多 少 人 用 餐 。 如 果 超 过 8 人 ， 就 打印 一 
条 消息 ， 指 出 没有 空 桌 ; 否则 指出 有 空 桌 。 
7-3 10 的 整数 倍 : 让 用 户 输入 一 个 数字 ， 并 指出 这 个 数字 是 否 是 10 的 整数 倍 。 


7.2 while 循环 简介 


for 循 环 用 于 针对 集合 中 的 每 个 元 素 都 一 个 代码 块 ， 而 while 循 环 不 断 地 运行 ， 直 到 指定 的 条 
件 不 满足 为 止 。 


7.2.1 使 用 while 循环 
你 可 以 使 用 while 循 环 来 数 数 ， 例 如 ， 下 面 的 while 循 环 从 1 数 到 5: 


counting.py 


current number = 1 

while current number <= 5: 
print(current number) 
current number += 1 


在 第 1 行 ， 我 们 将 current_number 设 置 为 !， 从 而 指定 从 1 开始 数 。 接 下 来 的 while 循 环 被 设置 
成 这 样 ， 只 要 current_number 小 于 或 等 于 $ ， 就 接着 运行 这 个 循环 。 循 环 中 的 代码 打印 
current_number 的 值 ， 青 使 用 代码 current_number += 1 (代码 current_number = Current number + 
1 的 简写 ) 将 其 值 加 1。 
只 要 满足 条 件 current_number <= 5，Python 就 接着 运行 这 个 循环 。 由 于 1 小 于 $， 因 此 Python 
打印 1, 并 将 current_number 加 1, 使 其 为 2; 由 于 2 小 于 $, 因此 Python 打印 2, 并 将 current_number 
加 1， 使 其 为 3， 以 此 类 推 。 一 旦 current_number 大 于 $， 循 环 将 停止 ， 整 个 程序 也 将 到 此 结束 : 
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Un 人 PP 情 


你 每 天 使 用 的 程序 很 可 能 就 包含 while 循 环 。 例 如， 游戏 使 用 while 循 环 ， 确 保 在 玩家 想 玩 时 
不 断 运 行 , 并 在 玩家 想 退 出 时 停止 运行 。 如 果 程 序 在 用 户 没有 让 它 停 止 时 停止 运行 , 或 者 在 用 户 
要 退出 时 还 继续 运行 ， 那 就 太 没有 意思 了 ; 有 鉴于 此 ，while 循 环 很 有 用 。 


7.2.2 ”让 用 户 选 择 何 时 退出 


可 使 用 while 循 环 让 程序 在 用 户 愿 意 时 不 断 地 运行 , 如 下 面 的 程序 parrotpy 所 示 。 我 们 在 其 中 
定义 了 一 个 退出 值 ， 只 要 用 户 输入 的 不 是 这 个 值 ， 程 序 就 接着 运行 : 


parrot.py 


@ prompt = "\nTell me something, and I will repeat it back to you:"' 
prompt += "\nEnter 'quit' to end the program. " 
@ message = "" 
四 while message != 'quit': 
message = input(prompt) 
print(message) 


在 @ 处 ,我们 定义 了 一 条 提示 消息 ， 告 诉 用 户 他 有 两 个 选择 : 要 么 输入 一 条 消息 ， 要 么 输 
人 退出 值 ( 这 里 为 'quit' )。 接 下 来 ,我 们 创建 了 一 个 变量 一 一 message ( 见 @ )， 用 于 存储 用 户 
输入 的 值 。 我 们 将 变量 message 的 初始 值 设 置 为 空 字符 串 "", 让 Python 首 次 执行 while 代 码 行 时 有 
可 供 检查 的 东西 。Python 首 次 执行 while 语 句 时 , 需要 将 message 的 值 与 'quit' 进 行 比较 , 但 此 时 
用 户 还 没有 输入 。 如 果 没 有 可 供 比 较 的 东西 ，Python 将 无 法 继续 运行 程序 。 为 解决 这 个 问题 ， 
我 们 必须 给 变量 message 指 定 一 个 初始 值 。 虽 然 这 个 初始 值 只 是 一 个 空 字符 串 ， 但 符合 要 求 ， 让 
Python 能 够 执行 while 循 环 所 需 的 比较 。 只 要 message 的 值 不 是 'quit' ， 这 个 循环 ( 见 @ ) 就 会 不 
斯 运行 。 

首次 遇 到 这 个 循环 时 ，message 是 一 个 空 字 符 串 ， 因 此 Python 进入 这 个 循环 。 执 行 到 代码 行 
message = input(prompt) 时 ，Python 显 示 提 示 消 息 ， 并 等 待 用 户 输入 。 不 管用 户 输入 是 什么 ， 都 
将 存储 到 变量 message 中 并 打印 出 来 ; 接 下 来 ,Python 重新 检查 while 语 句 中 的 条 件 。 只 要 用 户 输 
和 人 的 不 是 单词 'quit' ，Python 就 会 再 次 显示 提示 消息 并 等 待 用 户 输 入 。 等 到 用 户 终于 输入 'quit' 
后 ，Python 停 止 执 行 while 循 环 ， 而 整个 程序 也 到 此 结 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. Hello everyone! 
Hello everyone! 


Tell me something, and I will repeat it back to you: 
Enter ‘quit' to end the program. Hello again. 
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Hello again. 


Tell me something, and I will repeat it back to you: 
Enter ‘quit' to end the program. quit 
quit 


这 个 程序 很 好 ,唯一 美中不足 的 是 , 它 将 单词 'quit' 也 作为 一 条 消息 打印 了 出 来 。 为 修复 这 
种 问题 ， 只 需 使 用 一 个 简单 的 if 测 试 : 


prompt = "\nTell me something, and I will repeat it back to you:" 
prompt += "\nEnter 'quit' to end the program. " 

message = "" 

while message != "quit ' : 


message = input(prompt) 


if message != "quit': 
print(message) 


现在 ， 程 序 在 显示 消息 前 将 做 简单 的 检查 ， 仅 在 消息 不 是 退出 值 时 才 打印 它 : 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. Hello everyone! 
Hello everyone! 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. Hello again. 
Hello again. 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. quit 


7.2.3 ”使 用 标志 


在 前 一 个 示例 中 ， 我 们 让 程序 在 满足 指定 条 件 时 就 执 f J 特定 的 任务 。 但 在 更 复杂 的 程序 中 ， 
很 多 不 同 的 事件 都 会 导致 程序 停止 运行 ; 在 这 种 情况 下 ， 该 怎么 办 呢 ? 

例如 ,在 游戏 中 ,多 种 事件 都 可 能 导致 游戏 结束 ， 如 玩家 一 稻 飞 船 都 没有 了 或 要 保护 的 城市 
都 被 摧毁 了 。 导 致 程序 结束 的 事件 有 很 多 时 ， 如 果 在 一 条 while 语 句 中 检查 所 有 这 些 条 件 ， 将 既 

复杂 又 困难 。 

在 要 求 很 多 条 件 都 满足 才 继 续 运行 的 程序 中 , 可 定义 一 个 变量 , 用 于 判断 整个 程序 是 否 处 于 
活动 状态 。 这 个 变量 被 称 为 标志 ， 充 当 了 程序 的 交通 信号 灯 。 你 可 让 程序 在 标志 为 True 时 继续 运 
行 ， 并 在 任何 事件 导致 标志 的 值 为 False 时 让 程序 停止 运行 。 这 样 ， 在 while 语 句 中 就 只 需 检 查 一 

个 条 件 一 一 标志 的 当前 值 是 否 为 True， 并 将 所 有 测试 (是否 发 生 了 应 将 标志 设置 为 False 的 事件 ) 
都 放 在 其 他 地 方 ， 从 而 让 程序 变 得 更 为 整洁 。 
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下 面 来 在 前 一 节 的 程序 parrot.py 中 添加 一 个 标志 。 我 们 把 这 个 标志 命名 为 active ( 可 给 它 指 
定 任何 名 称 )， 它 将 用 于 判断 程序 是 否 应 继续 运行 : 


prompt = "\nTell me something, and I will repeat it back to you:" 
prompt += "\nEnter 'quit' to end the program. " 


@ active = True 
@ while active: 
message = input(prompt) 


(3 if message == "quit': 
active = False 
4 else: 
print(message) 


我 们 将 变量 active 设 置 成 了 True ( 见 @ )， 让 程序 最 初 处 于 活动 状态 。 这 样 做 简化 了 while 语 
句 ， 因 为 不 需要 在 其 中 做 任何 比较 一 一 相关 的 逻辑 由 程序 的 其 他 部 分 人 处理。 只 要 变量 active 为 
True， 循 环 就 将 继续 运行 ( 见 @ )。 

在 while 循 环 中 ， 我 们 在 用 户 输入 后 使 用 一 条 if 语句 来 检查 变量 message 的 值 。 如 果 用 户 输入 
的 是 'quit'( 见 @ )， 我 们 就 将 变量 active 设 置 为 False， 这 将 导致 While 循环 不 再 继续 执行 。 如 果 
用 户 输入 的 不 是 'quit'( 见 @ )， 我 们 就 将 输入 作为 一 条 消息 打印 出 来 。 

这 个 程序 的 输出 与 前 一 个 示例 相同 。 在 前 一 个 示例 中 , 我 们 将 条 件 测试 直接 放 在 了 while 语 句 
中 ， 而 在 这 个 程序 中 ， 我 们 使 用 了 一 个 标志 来 指出 程序 是 否 处 于 活动 状态 ,这样 如 果 要 添加 测试 
( 如 elif 语 句 ) 以 检查 是 否 发 生 了 其 他 导致 active 变 为 False 的 事件 ， 将 很 容易 。 在 复杂 的 程序 中 ， 
如 很 多 事件 都 会 导致 程序 停止 运行 的 游戏 中 ， 标 志 很 有 用 : 在 其 中 的 任何 一 个 事件 导致 活动 标志 
变 成 False 时 ， 主 游戏 循环 将 退出 ， 此 时 可 显示 一 条 游戏 结束 消息 ， 并 让 用 户 选 择 是 否 要 重新 玩 。 


7.2.4 使 用 break 退出 循环 


要 立即 退出 while 循 环 ， 不 再 运行 循环 中 余下 的 代码 ， 也 不 管 条 件 测试 的 结果 如 何 ， 可 使 用 
break 语 句 。break 语 句 用 于 控制 程序 流程 ， 可 使 用 它 来 控制 哪些 代码 行将 执行 ， 哪 些 代 码 行 不 执 
行 ， 从 而 让 程序 按 你 的 要 求 执 行 你 要 执行 的 代码 。 

例如 ， 来 看 一 个 让 用 户 指 出 他 到 过 哪些 地 方 的 程序 。 在 这 个 程序 中 ， 我 们 可 以 在 用 户 输入 
'quit' 后 使 用 break 语 句 立 即 退 出 while 循 环 : 


cities.py 


prompt = "\nPlease enter the name of a city you have visited:" 
prompt += "\n(Enter 'quit' when you are finished.) " 


@ while True: 
city = input(prompt) 


if city == 'quit": 
break 
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else: 


print("I'd love to go to "+ city.title() + "!") 


以 while True 打头 的 循环 ( 见 @ ) 将 不 断 运行 ， 直 到 遇 到 break 语 句 。 这 个 程序 中 的 循环 不 断 
输入 用 户 到 过 的 城市 的 名 字 ， 直 到 他 输入 'quit' 为 止 。 用 户 输 入 'quit' 后 , 将 执行 break 语 句 ， 导 
致 Python 退出 循环 : 


Please en 
(Enter 'q 
I'd love 


Please en 
(Enter 'q 
Id love 


Please en 
(Enter 'q 


ter the name of a < 
to go to New York! 


ter the name of a < 


uit' when you are fi 


ter the name of a ci 


ity you have visited: 
uit' when you are fi 


nished.) New York 


ity you have visited: 
uit' when you are fi 
to go to San Francisco! 


nished.) San Francisco 


ty you have visited: 


nished.) quit 


注意 ”在 任何 Python 循 环 中 都 可 使 用 break 语 句 。 例 如， 可 使 用 break 语 句 来 退出 遍历 列表 或 字典 
的 for 循 环 。 


7.2.5 在 循环 中 使 用 continue 


要 返回 到 循环 开头 ， 并 根据 条 件 测试 结果 决定 是 否 继续 执行 循环 ， 可 使 用 continue 语 句 ， 它 
不 像 break 语 名 那样 不 再 执行 余下 的 代码 并 退出 整个 循环 。 例 如 , 来 看 一 个 从 1 数 到 10, 但 只 打印 
其 中 偶数 的 循环 : 


counting.py 


current number = 0 
while current number < 10: 
@ current number += 1 
if current number % 2 == 0: 
continue 


print 


(current number) 


我 们 首先 将 current_number 设 置 成 了 0， 由 于 它 小 于 10，Python 进 入 while 循 环 。 进 入 循环 后 ， 
我 们 以 步 长 1 的 方式 往 上 数 ( 见 @ ), 因此 current_number 为 1。 接 下 来 , if 语 句 检 查 current_number 
与 2 的 求 模 运算 结果 。 如 果 结 
让 Python 忽略 余下 的 代码 ， 并 返回 到 循环 的 开头 。 如 果 当 前 的 数字 不 能 被 2 整除 ， 就 执行 循环 中 
余下 的 代码 ，Python 将 这 个 数字 打印 出 来 : 


为 0 ( 意味 着 current_number 可 被 2 整除 )， 就 执行 continue 语 句 ， 
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AD ~ ww 上 情 


7.2.6 ”避免 无 限 循 环 
每 个 while 循 环 都 必须 有 停止 运行 的 途径 ， 这 样 才 不 会 没完 没 了 地 执行 下 去 。 例 如 ， 下 面 的 


循环 从 1 数 到 5: 


counting.p 


y 


X = 工 


xX += 1 


We 5 2 


print(x) 


但 如 果 你 像 下 面 这 样 不 小 心 遗漏 了 代码 行 x += 1， 这 个 循环 将 没完 没 了 地 运行 : 


# 这 个 循环 将 没完 没 了 地 运行 | 


X = 工 


while x <= 5: 
print(x) 


在 这 里 ，x 的 初始 值 为 1， 但 根本 不 会 变 ， 因 此 条 件 测试 x <= 5 始终 为 True， 导 致 while 循 环 没 
完 没 了 地 打印 1， 如 下 所 示 : 


FF FF 


-- Snip-- 


每 个 程序 员 都 会 偶尔 因 不 小 心 而 编写 出 无 限 循环 ， 在 循环 的 退出 条 件 比 较 微妙 时 尤其 如 此 。 
如 果 程 序 陷 人 无 限 循环 ， 可 按 Ctrl + C， 也 可 关闭 显示 程序 输出 的 终端 窗口 。 
要 避免 编写 无 限 循环 ， 务 必 对 每 个 while 循 环 进行 测试 ， 确 保 它 按 预期 那样 结束 。 如 果 你 希 


望 程序 在 用 户 输 


和 入 特定 值 时 结束 , 可 运行 程序 并 输入 这 样 的 值 ; 如 果 在 这 种 情况 下 程序 没有 结 


请 检查 程序 处 型 
语句 得 以 执行 。 


这 个 值 的 方式 ,确认 程序 至 少 有 一 个 这 样 的 地 方 能 让 循环 条 件 为 False 或 让 break 


注意 ”有些 编辑 器 ( 如 Sublime Text ) 内 误 了 输出 窗口 ， 这 可 能 导致 难以 结束 无 限 循环 ， 因 此 不 
得 不 关闭 编辑 器 来 结束 无 限 循 环 。 
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动手 试 一 斌 


7-4 比萨 配料 : 编写 一 个 循环 ， 提 示 用 户 输 入 一 系列 的 比萨 配料 ， 并 在 用 户 输入 
'quit ' 时 结束 循环 。 每 当 用 户 输入 一 种 配料 后 ， 都 打印 一 条 消息 ， 说 我 们 会 在 比萨 中 添 
加 这 种 配料 。 

7-5 电影 票 : 有 家 电影 院 根据 观众 的 年 龄 收取 不 同 的 票 价 ; 不 到 3 岁 的 观众 免费 ; 
3~12 岁 的 观众 为 10 美元 ; 超过 12 岁 的 观众 为 15 美元 。 请 编写 一 个 循环 ， 在 其 中 询问 


用 户 的 年 龄 ， 并 指出 其 票 价 。 
7-6 三 个 出 口 :以 另 一 种 方式 完成 练习 7-4 或 练习 7-5, 在 程序 中 采取 如 下 所 有 做 法 。 
口 在 while 循环 中 使 用 条 件 测试 来 结束 循环 。 
口 使 用 变量 active 来 控制 循环 结束 的 时 机 。 
口 使 用 break 语句 在 用 户 输入 'quit' 时 退出 循环 。 
7-7 无 限 循环 : 编写 一 个 没完 没 了 的 循环 , 并 运行 它 ( 要 结束 该 循环 ， 可 按 Ctrl+C， 
也 可 关闭 显示 输出 的 窗口 )。 


7.3 使 用 while 循环 来 处 理 列表 和 字典 


到 目前 为 止 , 我 们 每 次 都 只 处 理 了 一 项 用 户 信息 : 获取 用 户 的 输入 ,再 将 输入 打印 出 来 或 作 
出 应 答 ; 循环 再 次 运行 时 , 我 们 获悉 另 一 个 输入 值 并 作出 响应 。 然 而 , 要 记录 大 量 的 用 户 和 信息 ， 
需要 在 while 循 环 中 使 用 列表 和 字典 。 

for 循 环 是 一 种 遍历 列表 的 有 效 方式 ， 但 在 for 循 环 中 不 应 修改 列表 ， 和 否则 将 导致 Python 难以 
跟踪 其 中 的 元 素 。 要 在 遍历 列表 的 同时 对 其 进行 修改 ， 可 使 用 while 循 环 。 通 过 将 while 循 环 同 列 
表 和 字典 结合 起 来 使 用 ， 可 收集 、 存 储 并 组 织 大 量 输入 ， 供 以 后 查看 和 显示 。 


7.3.1 在 列表 之 间 移 动 元 素 


假设 有 一 个 列表 ,其 中 包含 新 注册 但 还 未 验证 的 网 站 用 户 ; 验证 这 些 用 户 后 ， 如 何 将 他 们 移 
到 男 一 个 已 验证 用 户 列表 中 呢 ? 一 种 办 法 是 使 用 一 个 while 循 环 ， 在 验证 用 户 的 同时 将 其 从 未 验 
证 用 户 列表 中 提取 出 来 ， 再 将 其 加 入 到 另 一 个 已 验证 用 户 列 表 中 。 代 码 可 能 类 似 于 下 面 这样 : 


confirmed_users.py 


# 首先 ， 创 建 一 个 待 验证 用 户 列表 
# 和 一 个 用 于 存储 已 验证 用 户 的 空 列表 

@ unconfirmed users = ['alice', 'brian', "candace '] 
confirmed users = [] 


# 验证 每 个 用 户 ， 直 到 没有 未 验证 用 户 为 目 
# 将 每 个 经 过 验证 的 列表 都 移 到 已 验证 用 户 列 表 中 
@ while unconfirmed users: 
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3 current user = unconfirmed users.pop() 


print("Verifying user: " + current user.title()) 
@ confirmed users.append(current user) 


# 显示 所 有 已 验证 的 用 户 

print("\nThe following users have been confirmed:") 

for confirmed user in confirmed users: 
print(confirmed user.title()) 


我 们 首先 创建 了 一 个 未 验证 用 户 列表 ( 见 @ )， 其 中 包含 用 户 Alice 、Brian 和 Candace， 还 创 
建 了 一 个 空 列 表 ， 用 于 存储 已 验证 的 用 户 。@ 处 的 while 循 环 将 不 断 地 运行 ， 直 到 列表 
unconfirmed_users 变 成 空 的 。 在 这 个 循环 中 ，@ 处 的 函数 pop() 以 每 次 一 个 的 方式 从 列表 
unconfirmed_users 末 尾 删 除 未 验证 的 用 户 。 由 于 Candace 位 于 列表 unconfirmed_users 末 尾 ， 因 此 
其 名 字 将 首先 被 删除 、 存 储 到 变量 current_user 中 并 加 入 到 列表 confirmed_users 中 ( 见 @ )。 接 
下 来 是 Brian， 然 后 是 Alice。 
为 模拟 用 户 验证 过 程 , 我 们 打印 一 条 验证 消息 并 将 用 户 加 入 到 已 验证 用 户 列表 中 。 未 验证 用 
户 列表 越 来 越 短 ， 而 已 验证 用 户 列 表 越 来 越 长 。 未 验证 用 户 列表 为 空 后 结束 循环 ,再 打印 已 验证 
用 户 列表 : 


Verifying user: Candace 
Verifying user: Brian 
Verifying user: Alice 


The following users have been confirmed: 
Candace 

Brian 

Alice 


7.3.2 ”删除 包含 特定 值 的 所 有 列表 元 素 


在 第 3 章 中 ， 我 们 使 用 函数 remove() 来 删除 列表 中 的 特定 值 ， 这 之 所 以 可 行 ， 是 因为 要 删除 
的 值 在 列表 中 只 出 现 了 一 次 。 如 果 要 删除 列表 中 所 有 包含 特定 值 的 元 素 ， 该 怎么 办 呢 ? 

假设 你 有 一 个 宠物 列表 ， 其 中 包含 多 个 值 为 'cat' 的 元 素 。 要 删除 所 有 这 些 元 素 ， 可 不 断 运 
行 一 个 while 循 环 ， 直 到 列表 中 不 再 包含 值 'cat' ， 如 下 所 示 ; 


pets.py 


pets = ['dog', 'cat', 'dog', 'goldfish', 'cat', 'rabbit', 'cat'] 
print(pets) 


while 'cat' in pets: 
pets.remove('cat') 


print(pets) 
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我 们 首先 创建 了 一 个 列表 ， 其 中 包含 多 个 值 为 'cat ' 的 元 素 。 打 印 这 个 列表 后 ，Python 进 入 
while 循 环 ,因为 它 发 现 'cat ' 在 列表 中 至 少 出 现 了 一 次 。 进 入 这 个 循环 后 ,Python 删除 第 一 个 'cat' 
并 返回 到 while 代 码 行 ， 然 后 发 现 'cat ' 还 包含 在 列表 中 ， 因 此 再 次 进入 循环 。 它 不 断 删 除 'cat 


直到 这 个 值 不 再 包含 在 列表 中 ， 然 后 退出 循环 并 再 次 打印 列表 : 


['dog', 'cat', 'dog', 'goldfish', 'cat', 'rabbit', 'cat'] 
['dog', 'dog', 'goldfish', 'rabbit'] 


7.3.3 ”使 用 用 户 输入 来 填充 字典 


可 使 用 while 循 环 提示 用 户 输入 任意 数量 的 信息 。 下 面 来 创建 一 个 调查 程序 ， 其 中 的 循环 每 
次 执行 时 都 提示 输入 被 调查 者 的 名 字 和 回答 。 我 们 将 收集 的 数据 存储 在 一 个 字典 中 ,以 便 将 回答 


同 被 调查 者 关联 起 来 : 


mountain_poll.py 


responses = {} 


# 设置 一 个 标志 ， 指 出 调查 是 否 继续 
人 = True 


while polling active: 
# 提示 输入 被 调查 者 的 名 字 和 回答 
© name = input("\nWhat is your name? ") 
response = input("Which mountain would you like to climb someday? ") 


# 将 答卷 存储 在 字典 中 


@ Tesponses[name] = Tesponse 


# 看 看 是 否 还 有 人 要 参与 调查 
(3 repeat = input("Would you like to let another person respond? (yes/ no) ") 
if repeat == “no ' : 
polling active = False 


# 调查 结束 ， 显 示 结 果 
print("\n--- Poll Results ---") 
@ for name, response in responses.items(): 
print(name + " would like to climb " + response + ".") 


这 个 程序 首先 定义 了 一 个 空 字典 ( responses )， 并 设置 了 一 个 标志 ( polling_active ), 用 于 


指出 调查 是 否 继续 。 只 要 polling active 为 True，Python 就 运行 while 循 环 中 的 代码 。 


在 这 个 循环 中 ,提示 用 户 输入 其 用 户 名 及 其 喜欢 假 哪 座 山 ( 见 @ )。 将 这 些 信息 存储 在 字典 


ge 然后 询问 用 户 调查 是 否 继续 ( 见 @ )。 如 果 用 户 输入 yes， 程 序 将 再 


次 进入 


while 循 环 ; 如 果 用 户 输入 no， 标 志 polling_active 将 被 设置 为 False， 而 while 循 环 将 就 此 结束 。 


最 后 一 个 代码 块 ( 见 @ ) 显示 调查 结果 。 
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如 果 你 运行 这 个 程序 ， 并 输入 一 些 名 字 和 回答 ， 输 出 将 类 似 于 下 面 这 样 : 


hat is your name? Eric 
hich mountain would you like to climb someday? Denali 
ould you like to let another person respond? (yes/ no) yes 


hat is your name? Lynn 
hich mountain would you like to climb someday? Devil's Thumb 
ould you like to let another person respond? (yes/ no) no 


--- Poll Results --- 
Lynn would like to climb Devil's Thumb. 
Eric would like to climb Denali. 


i 
7-8 熟食 店 : 创建 一 个 名 为 sandwich orders 的 列表 ， 在 其 中 包含 各 种 三 明治 的 名 
字 ; 再 创建 一 个 名 为 finished sandwiches 的 空 列 表 。 遍 历 列 表 sandwich orders， 对 于 
其 中 的 每 种 三 明治 ， 都 打印 一 条 消息 ， 如 工 made your tuna sandwich， 并 将 其 移 到 列表 
finished sandwiches。 所 有 三 明治 都 制作 好 后 ， 打 印 一 条 消息 ， 将 这 些 三 明治 列 出 来 。 
7-9 五 香烟 是 牛 肉 (pastrami ) 卖 完 了 : 使 用 为 完成 练习 7-8 而 创建 的 列表 


sandwich orders， 并 确保 'pastrami' 在 其 中 至 少 出 现 了 三 次 。 在 程序 开头 附近 添加 这 样 
的 代码 : 打印 一 条 消息 ， 指 出 熟食 店 的 五 香烟 束 牛 肉 卖 完了 ; 再 使 用 一 个 while 循环 将 
列表 sandwich orders 中 的 'pastrami' 都 删除 。 确认 最 终 的 列表 finished sandwiches 中 
不 包含 'pastrami'。 

7-10 梦想 的 度假 胜地 : 编写 一 个 程序 ， 调 查 用 户 梦 想 的 度假 胜地 。 使 用 类 似 于 “If 


人 


you could visit one place in the world, where would you g0?” 的 提示 ， 并 编写 一 个 打印 调 
查 结果 的 代码 块 。 


7.4 ”小结 


在 本 章 中 ， 你 学 习 了 : 如 何在 程序 中 使 用 input() 来 让 用 户 提 供 信 息 ; 如 何 处 理 文 本 和 数字 
输入 , 以 及 如 何 使 用 while 循 环 让 程序 按 用 户 的 要 求 不 断 地 运行 ; 多 种 控制 while 循 环流 程 的 方式 : 
设置 活动 标志 、 使 用 break 语 句 以 及 使 用 continue 语 句 ; 如 何 使 用 while 循 环 在 列表 之 间 移 动 元 素 ， 
以 及 如 何 从 列表 中 删除 所 有 包含 特定 值 的 元 素 ; 如 何 结合 使 用 while 循 环 和 字典 。 

在 第 8 章 中 ， 你 将 学 习 函 数 。 函 数 让 你 能 够 将 程序 分 成 多 个 很 小 的 部 分 ， 其 中 每 部 分 都 负责 
完成 一 项 具体 任务 。 你 可 以 根据 需要 调用 同一 个 函数 任意 次 ， 还 可 将 函数 存储 在 独立 的 文件 中 。 
使 用 函数 可 让 你 编写 的 代码 效率 更 高 ， 更 容易 维护 和 排除 故障 ， 还 可 在 众多 不 同 的 程序 中 重用 。 
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在 本 章 中 ,你 将 学 习 编写 函数 。 函 数 是 带 名 字 的 代码 块 ， 用 于 完 
成 具体 的 工作 。 

要 执行 函数 定义 的 特定 任务 , 可 调用 该 函数 。 需要 在 程序 中 多 次 
执行 同一 项 任务 时 , 你 无 需 反 复 编写 完成 该 任务 的 代码 , 而 只 需 调 用 
执行 该 任务 的 函数 ， 让 Python 运 行 其 中 的 代码 。 你 将 发 现 ， 通过 使 用 
函数 ， 程 序 的 编写 、 阅 读 、 测 试 和 修复 都 将 更 容易 。 

在 本 章 中 ， 你 还 会 学 习 向 函数 传递 信息 的 方式 。 你 将 学 习 如 何 
编写 主要 任务 是 显示 信息 的 函数 ， 还 有 用 于 处 理 数 据 并 返回 一 个 或 
一 组 值 的 函数 。 最 后 ， 你 将 学 习 如 何 将 函数 存储 在 被 称 为 模块 的 独 
立 文件 中 ， 让 主 程序 文件 的 组 织 更 为 有 序 。 


8.1 定义 函数 
下 面 是 一 个 打印 问候 语 的 简单 函数 ， 名 为 greet_user(): 


greeter.py 


@ def greet user(): 
@ "uu 显示 简单 的 问候 语 """ 
(3 print("Hello!") 


@ greet user() 


这 个 示例 演示 了 最 简单 的 函数 结构 。@ 处 的 代码 行使 用 关键 字 def 来 告诉 Python 你 要 定义 一 个 
函数 。 这 是 函数 定义 ,向 Python 指 出 了 函数 名 ,还 可 能 在 括号 内 指出 函数 为 完成 其 任务 需要 什么 
样 的 信息 。 在 这 里 ， 函 数 名 为 greet_user()， 它 不 需要 任何 信息 就 能 完成 其 工作 ， 因 此 括号 是 空 
的 (即便 如 此 ， 插 号 也 必 不 可 少 )。 最后， 定义 以 冒号 结尾 。 

紧 跟 在 def greet_user(): 后 面 的 所 有 缩 进 行 构成 了 函数 体 。@ 处 的 文本 是 被 称 为 文档 字符 串 
( docstring ) 的 注释 ,描述 了 函数 是 做 什么 的 。 文 档 字 符 串 用 三 引号 括 起 , Python 使 用 它们 来 生成 
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有 关 程 序 中 函数 的 文档 。 

代码 行 print("Hellol")( 见 @ ) 是 函数 体内 的 唯一 一 行 代 码 ，greet_user() 只 做 一 项 工作 : 
打印 Hellol。 

要 使 用 这 个 函数 ， 可 调用 它 。 函 数 调用 让 Python 执 行 函 数 的 代码 。 要 调用 函数 ， 可 依次 指定 
函数 名 以 及 用 括号 括 起 的 必要 信息 ， 如 @ 处 所 示 。 由 于 这 个 函数 不 需要 任何 信息 ， 因 此 调用 它 时 
只 需 输 入 greet_user() 即 可 。 和 预期 的 一 样 ， 它 打印 Hellol : 


Hello! 


8.1.1 向 函数 传递 信息 


只 需 稍 作 修 改 ， 就 可 以 让 函数 greet_user() 不 仅 向 用 户 显示 Hello!， 还 将 用 户 的 名 字 用 作 挫 
头 。 为 此 ， 可 在 琢 数 定义 def greet_user() 的 括号 内 添加 username。 通 过 在 这 里 添加 username， 
就 可 让 函数 接受 你 给 username 指 定 的 任何 值 。 现 在 ， 这 个 函数 要 求 你 调用 它 时 给 username 指 定 一 
个 值 。 调 用 greet_user() 时 ， 可 将 一 个 名 字 传 递 给 它 ， 如 下 所 示 : 


def greet user(username): 
mm 显示 简单 的 问候 语 "" 
print("Hello, " + username.title() + "!") 


greet user('jesse') 


代码 greet_user('jesse' ) 调 用 函数 greet_user(), 并 向 它 提供 执行 print 语 句 所 需 的 信息 。 这 
个 函数 接受 你 传递 给 它 的 名 字 ， 并 向 这 个 人 发 出 问候 : 


Hello, Jesse! 


同样 ，greet_user('sarah' ) 调 用 函数 greet_user() 并 向 它 传递 'sarah' ， 打 EhHello，Sarah!。 
你 可 以 根据 需要 调用 函数 greet_user() 任 意 次 ， 调 用 时 无 论 传 人 什么 样 的 名 字 ， 都 会 生成 相应 的 
输出 。 


8.1.2” 实 参 和 形 参 


前 面 定义 函数 greet_user() 时 ， 要 求 给 变量 username 指 定 一 个 值 。 调 用 这 个 函数 并 提供 这 种 
言 息 (人 名 ) 时 ， 它 将 打印 相应 的 问候 语 。 

在 函数 greet_user() 的 定义 中 ， 变 量 username 是 一 个 形 参 函数 完成 其 工作 所 需 的 一 项 信 
息 。 在 代码 greet_user('jesse') 中 ,， 值 'jesse' 是 一 个 实 参 。 实 参 是 调用 函数 时 传递 给 函数 的 信 
息 。 我 们 调用 函数 时 ， 将 要 让 函数 使 用 的 信息 放 在 括号 内 。 在 greet_user( 'jesse' ) 中 ， 将 实 参 
'jesse ' 传 递 给 了 函数 greet_user() ， 这 个 值 被 存储 在 形 参 username 中 。 
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注意 大 家 有 时 候 会 形 参 、 实 参 不 分 ， 因 此 如 果 你 看 到 有 人 将 函数 定义 中 的 变量 称 为 实 参 或 将 
函数 调用 中 的 变量 称 为 形 参 ， 不 要 大 惊 小 怪 。 


动手 试 一 斌 
8-1 消息 : 编写 一 个 名 为 display _ message() 的 函数 ， 它 打印 一 个 句子 ， 指 出 你 在 本 
章 学 的 是 什么 。 调 用 这 个 函数 ， 确 认 显示 的 消息 正确 无 误 。 


8-2 喜欢 的 图 书 : 编写 一 个 名 为 favorite book() 的 函数 ， 其 中 包含 一 个 名 为 title 
的 形 参 。 这 个 函数 打印 一 条 消息 ， 如 One of my favorite books is Alice in Wonderland。 
调用 这 个 函数 ， 并 将 一 本 图 书 的 名 称 作 为 实 参 传递 给 它 。 


8.2 ”传递 实 参 


鉴于 函数 定义 中 可 能 包含 多 个 形 参 , 因此 函数 调用 中 也 可 能 包含 多 个 实 参 。 向 函数 传递 实 参 
的 方式 很 多 ,可 使 用 位 置 实 参 , 这 要 求实 参 的 顺序 与 形 参 的 顺序 相同 ; 也 可 使 用 关键 字 实 参 ， 其 
中 每 个 实 参 都 由 变量 名 和 值 组 成 ; 还 可 使 用 列表 和 字典 。 下 面 来 依次 介绍 这 些 方式 。 


8.2.1 位置 实 参 


你 调用 函数 时 , Python 必须 将 函数 调用 中 的 每 个 实 参 都 关联 到 函数 定义 中 的 一 个 形 参 。 为 此 ， 
最 简单 的 关联 方式 是 基于 实 参 的 顺序 。 这 种 关联 方式 被 称 为 位 置 实 参 。 

为 明白 其 中 的 工作 原理 , 来 看 一 个 显示 宠物 信息 的 函数 。 这 个 函数 指出 一 个 宠物 属于 哪 种 动 
物 以 及 它 叫 什么 名 字 ， 如 下 所 示 : 


pets.py 


@ def describe pet(animal type, pet name): 
mm 显示 完 物 的 信息 """ 
print("\nI have a " + animal type + ".") 
print("My "+ animal type + "'s name is "+ pet name.title() + ".") 


@ describe pet('hamster', 'harry') 


这 个 函数 的 定义 表明 ， 它 需要 一 种 动物 类 型 和 一 个 名 字 ( 见 @ )。 调 用 describe pet() 时 , 需 
要 按 顺 序 提供 一 种 动物 类 型 和 一 个 名 字 。 例 如 ， 在 前 面 的 函数 调用 中 ， 实 参 'hamster' 存 储 在 形 
参 animal type 中 ， 而 实 参 'harry ' 存 储 在 形 参 pet_name 中 ( 见 @ )。 在 函数 体内 ， 使 用 了 这 两 个 形 
参 来 显示 宠物 的 信息 。 

输出 描述 了 一 只 名 为 Harry 的 仓鼠 : 


I have a hamster. 
My hamster's name is Harry. 


1. 调用 函数 多 次 
你 可 以 根据 需要 调用 函数 任意 次 。 要 再 描述 一 个 宠物 ， 只 需 再 次 调用 describe pet() 即 可 : 


def describe pet(animal type, pet name): 
”显示 宠物 的 信息 "” 
print("\nI have a " + animal type + ".") 
print("My "+ animal type + "'s name is "+ pet name.title() + ".") 


describe pet('hamster', 'harry') 
describe pet('dog', 'willie') 


第 二 次 调用 describe_pet() 函 数 时 ， 我 们 向 它 传递 了 实 参 'dog' 和 'willie' 。 与 第 一 次 调用 时 
一 样 ，Python 将 实 参 ' dog' 关 联 到 形 参 animal_type， 并 将 实 参 'willie' 关 联 到 形 参 pet_name。 与 前 


面 一 样 ， 这 个 函数 完成 其 任务 ， 但 打印 的 是 一 条 名 为 Willie 的 小 狗 的 信息 。 至 此 ， 我 们 有 一 只 名 8 


为 Harry 的 仓鼠 ， 还 有 一 条 名 为 Willie 的 小 狗 : 


I have a hamster. 
My hamster's name is Harry. 


I have a dog. 
My dog's name is Willie. 


调用 函数 多 次 是 一 种 效率 极 高 的 工作 方式 。 我 们 只 需 在 函数 中 编写 描述 宠物 的 代码 一 次 , 然 
后 每 当 需 要 描述 新 宠物 时 ,都 可 调用 这 个 函数 ,并 向 它 提供 新 宠物 的 信息 。 即 便 描述 宠物 的 代码 
增加 到 了 10 行 ， 你 依然 只 需 使 用 一 行 调用 函数 的 代码 ， 就 可 描述 一 个 新 宠物 。 

在 函数 中 ， 可 根据 需要 使 用 任意 数量 的 位 置 实 参 ， Python 将 按 顺 序 将 函数 调用 中 的 实 参 关 联 
到 函数 定义 中 相应 的 形 参 。 

2. 位 置 实 参 的 顺序 很 重要 

使 用 位 置 实 参 来 调用 函数 时 ， 如 果实 参 的 顺序 不 正确 ， 结 果 可 能 出 乎 意料 : 


def describe pet(animal type, pet name): 
""" 显 示 完 物 的 信息 """ 
print("\nI have a " + animal type + ".") 
print("My "+ animal type + "'s name is "+ pet name.title() + ".") 


describe pet('harry', 'hamster') 
在 这 个 函数 调用 中 ， 我 们 先 指 定名 字 ， 青 指定 动物 类 型 。 由 于 实 参 'harry ' 存 前， 这 个 值 将 


存储 到 形 参 animal_type 中 ; 同 理 ，'hamster' 将 存储 到 形 参 pet_name 中 。 结 果 是 我 们 得 到 了 一 个 
名 为 Hamster 的 harry: 


A 
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I have a harry. 
My harry's name is Hamster. 


如 果 结 果 像 上 面 一 样 搞笑 ， 请 确认 函数 调用 中 实 参 的 顺序 与 函数 定义 中 形 参 的 顺序 一 致 。 


8.2.2 ”关键 字 实 参 

关键 字 实 参 是 传递 给 函数 的 名 称 - 值 对 。 你 直接 在 实 参 中 将 名 称 和 值 关联 起 来 了 ， 因 此 向 也 
数 传递 实 参 时 不 会 混淆 ( 不 会 得 到 名 为 Hamster 的 harry 这 样 的 结果 ), 关键 字 实 参 让 你 无 需 考 虑 子 
数 调用 中 的 实 参 顺序 ， 还 清楚 地 指出 了 函数 调用 中 各 个 值 的 用 途 。 

下 面 来 重新 编写 pets.py， 在 其 中 使 用 关键 字 实 参 来 调用 describe pet(): 


def describe pet(animal type, pet name): 
"" "显示 完 物 的 信息 """ 
print("\nI have a " + animal type + ".") 
print("My "+ animal type + "'s name is "+ pet name.title() + ".") 


describe pet(animal type="'hamster', pet name="harry') 

函数 describe pet() 还 是 原来 那样 ， 但 调用 这 个 函数 时 ， 我 们 向 Python 明确 地 指出 了 各 个 实 
参 对 应 的 形 参 。 看 到 这 个 函数 调用 时 ，Python 知 道 应 该 将 实 参 'hamster' 和 'harry' 分 别 存 储 在 形 
参 animal_type 和 pet_name 中 。 输 出 正确 无 误 ， 它 指出 我 们 有 一 只 名 为 Harry 的 仓鼠 。 

关键 字 实 参 的 顺序 无 关 紧要 ， 因 为 Python 知道 各 个 值 该 存储 到 哪个 形 参 中 。 下 面 两 个 函数 调 
用 是 等 效 的 : 


describe pet(animal type="'hamster', pet name="'harry') 
describe pet(pet name='harry', animal type='hamster') 


注意 使 用 关键 字 实 参 时 ,务必 准确 地 指定 函数 定义 中 的 形 参 名 。 


8.2.3 默认 值 
遍 写 限 数 时 ， 可 给 每 个 形 参 指定 默认 值 。 在 调用 孔 数 中 给 形 参 提供 了 实 参 时 ，Python 将 使 用 
此 定 的 实 参 值 ; 否则 ,将 使 用 形 参 的 默认 值 。 因 此 ， 给 形 参 指定 默认 值 后 ， 可 在 函数 调用 中 省 略 
相应 的 实 参 。 使 用 默认 值 可 简化 函数 调用 ， 还 可 清楚 地 指出 函数 的 典型 用 法 。 

例如 ， 如 果 你 发 现 调用 describe_pet() 时 ,描述 的 大 都 是 小 狗 ， 就 可 将 形 参 animal_type 的 默 


认 值 设置 为 'dog' 。 这 样 ， 调 用 describe pet() 来 描述 小 狗 时 ， 就 可 不 提供 这 种 信息 : 


汶 


def describe pet(pet name, animal type='dog'): 
"" "显示 完 物 的 信息 """ 
print("\nI have a " + animal type + ".") 
print("My "+ animal type + "'s name js "+ pet name.title() + ".") 
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describe pet(pet name="'willie') 


这 里 修改 了 函数 describe_pet() 的 定义 ， 在 其 中 给 形 参 animal type 指定 了 默认 值 'dog' 。 这 
样 ， 调 用 这 个 函数 时 ， 如 果 没 有 给 animal_ type 指定 值 ，Python 将 把 这 个 形 参 设 置 为 'dog ' : 


I have a dog. 
My dog's name is Willie. 


请 注意 ， 在 这 个 函数 的 定义 中 ， 修 改 了 形 参 的 排列 顺序 。 由 于 给 animal type 指 定 了 默认 值 ， 
无 需 通 过 实 参 来 指定 动物 类 型 , 因此 在 函数 调用 中 只 包含 一 个 实 参 宠物 的 名 字 。 然 而 ,Python 
依然 将 这 个 实 参 视 为 位 置 实 参 , 因此 如 果 函 数 调用 中 只 包含 宠物 的 名 字 , 这 个 实 参 将 关联 到 函数 
定义 中 的 第 一 个 形 参 。 这 就 是 需要 将 pet_name 放 在 形 参 列表 开头 的 原因 所 在 。 

现在 ， 使 用 这 个 函数 的 最 简单 的 方式 是 ， 在 函数 调用 中 只 提供 小 狗 的 名 字 : 


describe pet('willie') 


这 个 函数 调用 的 输出 与 前 一 个 示例 相同 。 只 提供 了 一 个 实 参 一 一 'willie' ， 这 个 实 参 将 关联 | 
到 函数 定义 中 的 第 一 个 形 参 一 -pet_name。 由 于 没有 给 animal_type 提 供 实 参 ,因此 Python 使 用 其 
默认 值 'dog ' 。 

如 果 要 描述 的 动物 不 是 小 狗 ， 可 使 用 类 似 于 下 面 的 函数 调用 : 


describe pet(pet name="'harry', animal type="'hamster') 


由 于 显 式 地 给 animal type 提 供 了 实 参 ， 因 此 Python 将 忽略 这 个 形 参 的 默认 值 。 
注意 使 用 默认 值 时 ， 在 形 参 列表 中 必须 先 列 出 没有 默认 值 的 形 参 ， 再 列 出 有 默认 值 的 实 参 。 
这 让 Python 依 然 能 够 正确 地 解读 位 置 实 参 。 
8.2.4 ”等 效 的 函数 调用 


鉴于 可 混合 使 用 位 置 实 参 、 关 键 字 实 参 和 默认 值 , 通常 有 多 种 等 效 的 函数 调用 方式 。 请 看 下 
面 的 函数 describe pets() 的 定义 ， 其 中 给 一 个 形 参 提供 了 默认 值 : 


def describe pet(pet name, animal type="'dog'): 


基于 这 种 定义 , 在 任何 情况 下 都 必须 给 pet_name 提 供 实 参 ; 指定 该 实 参 时 可 以 使 用 位 置 方式 ， 
也 可 以 使 用 关键 字 方 式 。 如 果 要 描述 的 动物 不 是 小 狗 ， 还 必须 在 函数 调用 中 给 animal type 提 供 
实 参 ; 同样 ， 指 定 该 实 参 时 可 以 使 用 位 置 方式 ， 也 可 以 使 用 关键 字 方 式 。 
下 面 对 这 个 函数 的 所 有 调用 都 可 行 
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# 一 条 名 为 Nillie 的 小 狗 
describe pet('willie') 
describe pet(pet name="'willie') 


# 一 只 名 为 HarTy 的 仓鼠 

describe pet('harry', 'hamster') 
describe pet(pet name="'harry', animal type="'hamster') 
describe pet(animal type="'hamster', pet name="harry') 


这 些 函 数 调用 的 输出 与 前 面 的 示例 相同 。 


注意 使 用 哪 种 调用 方式 无 关 紧 要 ， 只 要 函数 调用 能 生成 你 希望 的 输出 就 


8 


在 


容易 理解 的 调用 方式 即 可 。 


.2.5 ”避免 实 参 错误 


行 。 使 用 对 你 来 说 最 


等 你 开始 使 用 函数 后 ， 如 果 遇 到 实 参 不 匹配 错误 , 不 要 大 惊 小 怪 。 你 提供 的 实 参 多 于 或 少 于 
函数 完成 其 工作 所 需 的 信息 时 ， 将 出 现实 参 不 匹配 错误 。 例 如 ， 如 果 调 用 函数 describe_pet() 时 
没有 指定 任何 实 参 ， 结 果 将 如 何 呢 ? 


def describe pet(animal type, pet name): 
"" "显示 完 物 的 信息 """ 
print("\nI have a " + animal type + ".") 
print("My "+ animal type + "'s name js "+ pet name.title() + ".") 


describe pet() 


Python 发 现 该 函数 调用 缺少 必要 的 信息 ， 而 traceback 指 出 了 这 一 点 : 


Traceback (most recent call last): 

@ File "pets.py", line 6, in <module> 

@ describe pet() 

@ TypeError: describe pet() missing 2 required positional arguments: 'animal_ 
type' and “pet_name 


在 @ 处 ，traceback 指 出 了 问题 出 在 什么 地 方 ， 让 我 们 能 够 回 过 头 去 找 出 


函数 调用 中 的 错误 。 


@ 处 ,指出 了 导致 问题 的 函数 调用 。 在 人 @ 处 ，traceback 指 出 该 函数 调用 少 


两 个 实 参 ， 并 指出 了 


相应 形 参 的 名 称 。 如 果 这 个 函数 存储 在 一 个 独立 的 文件 中 , 我 们 也 许 无 需 打开 这 个 文件 并 查看 函 


数 


日 
全 


侣 已 
HE 


的 代码 ， 就 能 重新 正确 地 编写 函数 调用 。 


Python 读 取 函 数 的 代码 ， 并 指出 我 们 需要 为 哪些 形 参 提供 实 参 ， 这 提供 


了 极 大 的 帮助 。 这 也 


应 该 给 变量 和 函数 指定 描述 性 名 称 的 另 一 个 原因 ; 如 果 你 这 样 做 了 , 那么 无 论 对 于 你 ,还 是 可 


更 用 你 编写 的 代码 的 其 他 任何 人 来 说 ，Python 提 供 的 错误 消息 都 将 更 有 帮助 。 


如 果 提 供 的 实 参 太 多 ， 将 出 现 类 似 的 traceback， 帮 助 你 确保 柱 数 调用 和 函数 定义 匹配 。 
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动手 试 一 斌 


8-3 T 恤 : 编写 一 个 名 为 make shirt() 的 函数 ， 它 接受 一 个 尺码 以 及 要 印 到 本 恤 上 
的 字样 。 这 个 函数 应 打印 一 个 句子 ,概要 地 说 明 芽 恤 的 尺码 和 字样 。 

使 用 位 置 实 参 调用 这 个 函数 来 制作 一 件 工 恤 ; 再 使 用 关键 字 实 参 来 调用 这 个 函数 。 

8-4 大 号 工 几 :修改 函数 make _ shirt() ,使 其 在 默认 情况 下 制作 一 件 印 有 字样 "Ilove 


Python” 的 大 号 T 几 。 调 用 这 个 函数 来 制作 如 下 工 几 : 一 件 印 有 默认 字样 的 大 号 工 几 、 
一 件 印 有 默认 字样 的 中 号 T 恤 和 一 件 印 有 其 他 字样 的 T 虱 ( 尺码 无 关 紧 要 )。 

8-5 城市 : 编写 一 个 名 为 describe city() 的 函数 ， 它 接受 一 座 城市 的 名 字 以 及 该 城 
市 所 属 的 国家 。 这 个 函数 应 打印 一 个 简单 的 句子 ， 如 Reykjavik is in Iceland。 给 用 
于 存储 国家 的 形 参 指定 默认 值 。 为 三 座 不 同 的 城市 调用 这 个 函数 ， 且 其 中 至 少 有 一 座 城 
市 不 属于 默认 国家 。 


8.3 返回 值 


函数 并 非 总 是 直接 显示 输出 ,相反 ， 它 可 以 处 理 一 些 数据 ， 并 返回 一 个 或 一 组 值 。 函 数 返 回 
的 值 被 称 为 返回 值 。 在 函数 中 ， 可 使 用 return 语 句 将 值 返回 到 调用 函数 的 代码 行 。 返 回 值 让 你 能 
够 将 程序 的 大 部 分 繁重 工作 移 到 函数 中 去 完成 ， 从 而 简化 主 程序 。 


8.3.1 返回 简单 值 
下 面 来 看 一 个 函数 ， 它 接受 名 和 姓 并 返回 整洁 的 姓名 : 


formatted_name.py 


@ def get formatted name(first name, last name) 
"返回 整洁 的 姓名 """ 

@ full name = first name + ' ' + last name 

(3 return full name.title() 


@ musician = get formatted name('jimi', 'hendrix') 
print(musician) 


函数 get_formatted name() 的 定义 通过 形 参 接受 名 和 姓 ( 见 @ )。 它 将 姓 和 名 合 而 为 一 ， 在 它 
们 之 间 加 上 一 个 空格 ,并 将 结果 存储 在 变量 full_name 中 ( 见 @ )。 然 后, 将 full_name 的 值 转换 为 
首 字母 大 写 格式 ， 并 将 结果 返回 到 函数 调用 行 ( 见 @ )。 
调用 返回 值 的 函数 时 , 需要 提供 一 个 变量 ,用 于 存储 返回 的 值 。 在 这 里 , 将 返回 值 存储 在 了 
量 musician 中 ( 见 @ )。 输 出 为 整洁 的 姓名 : 


ha 


Jimi Hendrix 
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我 们 原本 只 需 编写 下 面 的 代码 就 可 输出 整洁 的 姓名 ， 相 比 于 此 ， 前 面 做 的 工作 好 像 太 多 了 : 


print("Jimi Hendrix") 


但 在 需要 分 别 存储 大 量 名 和 姓 的 大 型 程序 中 , 像 get_formatted_name() 这 样 的 函数 非常 有 用 。 
你 分 别 存储 名 和 姓 ， 每 当 需 要 显示 姓名 时 都 调用 这 个 函数 。 


8.3.2 ”让 实 参 变 成 可 选 的 


有 时 候 , 需要 让 实 参 变 成 可 选 的 , 这 样 使 用 函数 的 人 就 只 需 在 必要 时 才 提 供 额 外 的 信息 。 可 


使 用 默认 值 来 让 实 参 变 成 可 选 的 。 
例如 ， 假 设 我 们 要 扩展 函数 get_formatted_name() ， 使 其 还 处 理 中 间 名 。 为 此 ， 可 将 其 修改 


成 类 似 于 下 面 这 样 : 


def get formatted name(first name, middle name, last name): 


""" 返 回 整洁 的 姓名 " 


full name = first name + ' ' + middle name + ' ' + last name 
return full name.title() 


musician = get formatted name('john', 'lee', 'hooker') 


print(musician) 


只 要 同时 提供 名 、 中 间 名 和 姓 , 这 个 函数 就 能 正确 地 运行 。 它 根据 这 三 部 分 创建 一 个 字符 串 ， 


在 适当 的 地 方 加 上 空格 ， 并 将 结果 转换 为 首 字 母 大 写 格 式 : 


John Lee Hooker 


然而 , 并 非 所 有 的 人 都 有 中 间 名 , 但 如 果 你 调用 这 个 函数 时 只 提供 了 名 和 姓 , 它 将 不 能 正确 


地 运行 。 为 让 中 间 名 变 成 可 选 的 ， 可 给 实 参 middle_name 指 定 一 个 默认 值 一 一 空 字符 串 ， 并 在 用 


户 没 有 提供 中 间 名 时 不 使 用 这 个 实 参 ,为 让 get_formatted_name() 在 没有 提供 中 间 名 时 依然 可 行 ， 


可 给 实 参 middle_name 指 定 一 个 默认 值 


空 字符 串 ， 并 将 其 移 到 形 参 列表 的 末尾 : 


@ def get formatted name(first name, last name, middle name=""'): 


"" "返回 整洁 的 姓名 


@ if middle name: 
full name = 
(3 else: 
full name = 


return full name.t 


musician = get format 


print(musician) 


print (musician) 


first name + ' ' + middle name + ' ' + last name 
first name + ' ' + last name 
itle() 


ted name('jimi', 'hendrix') 


@ musician = get formatted name('john', 'hooker', 'lee') 
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在 这 个 示例 中 ,姓名 是 根据 三 个 可 能 提供 的 部 分 创建 的 。 由 于 人 都 有 名 和 姓 ,， 因 此 在 函数 定 
义 中 首先 列 出 了 这 两 个 形 参 。 中 间 名 是 可 选 的 ,因此 在 函数 定义 中 最 后 列 出 该 形 参 ， 并 将 其 默认 
值 设置 为 空 字符 串 ( 见 @ )。 

在 函数 体 中 ,我们 检查 是 否 提供 了 中 间 名 。Python 将 非 空 字 符 串 解读 为 True， 因 此 如 果 气 数 
调用 中 提供 了 中 间 和 名，if middle_name 将 为 True ( 见 @ )。 如 果 提 供 了 中 间 名 ， 就 将 名 、 中 间 名 和 
姓 合并 为 姓名 ， 然 后 将 其 修改 为 首 字 母 大 写 格式 ， 并 返回 到 函数 调用 行 。 在 函数 调用 行 , 将 返回 
的 值 存储 在 变量 musician 中 ; 然后 将 这 个 变量 的 值 打印 出 来 。 如 果 没 有 提供 中 间 名 ,middle_name 
将 为 空 字符 串 ， 导 致 i 测试 未 通过 ， 进 而 执行 else 代 码 块 ( 见 @ ): 只 使 用 名 和 姓 来 生成 姓名 ， 
并 将 设置 好 格式 的 姓名 返回 给 函数 调用 行 。 在 函数 调用 行 ， 将 返回 的 值 存储 在 变量 musician 中 ; 
然后 将 这 个 变量 的 值 打印 出 来 。 

调用 这 个 函数 时 ， 如 果 只 想 指定 名 和 姓 ， 调 用 起 来 将 非常 简单 。 如 果 还 要 指定 中 间 名 ， 就 必 
须 确保 它 是 最 后 一 个 实 参 ， 这 样 Python 才 能 正确 地 将 位 置 实 参 关联 到 形 参 ( 见 @ )。 

这 个 修改 后 的 版 本 适用 于 只 有 名 和 姓 的 人 ， 也 适用 于 还 有 中 间 名 的 人 : 


Jimi Hendrix 
John Lee Hooker 


可 选 值 让 函数 能 够 处 理 各 种 不 同情 形 的 同时 ， 确 保函 数 调用 尽 可 能 简单 。 
8.3.3 返回 字典 


函数 可 返回 任何 类 型 的 值 , 包括 列表 和 字典 等 较 复 杂 的 数据 结构 。 例 如 ， 下 面 的 函数 接受 姓 
名 的 组 成 部 分 ， 并 返回 一 个 表示 人 的 字典 : 


person.py 


def build person(first name, last name): 
"" "返回 一 个 字典 ， 其 中 包含 有 关 一 个 人 的 信息 """ 
@ person = { first': first name， 'last': last name} 
© return person 


musician = build person('jimi', 'hendrix') 
®@ print(musician) 


函数 build_person() 接 受 名 和 姓 , 并 将 这 些 值 封 装 到 字典 中 ( 见 @ )。 存储 first_name 的 值 时 ， 
使 用 的 键 为 'first' ， 而 存储 1ast_name 的 值 时 ， 使 用 的 键 为 ' last' 。 最 后 ， 返 回 表 示人 的 整个 字 
典 ( 见 @ )。 在 @ 处 ,打印 这 个 返回 的 值 ， 此 时 原来 的 两 项 文本 信息 存储 在 一 个 字典 中 : 


{'first': 'jimi', 'last': 'hendrix'} 


这 个 函数 接受 简单 的 文本 信息 , 将 其 放 在 一 个 更 合适 的 数据 结构 中 , 让 你 不 仅 能 打印 这 些 信 
息 , 还 能 以 其 他 方式 处 理 它们 。 当 前 , 字符 串 'jimi' 和 'hendrix' 被 标记 为 名 和 姓 。 你 可 以 轻松 地 
扩展 这 个 限 数 ,使 其 接受 可 选 值 ， 如 中 间 名 、 年 龄 、 职 业 或 你 要 存储 的 其 他 任何 信息 。 例 如 ， 下 


124 第 8 章 函数 


面 的 修改 让 你 还 能 存储 年 龄 : 


def build person(first name, last name, age="'): 
"" "返回 一 个 字典 ， 其 中 包含 有 关 一 个 人 的 信息 """ 
person = {'first': first name, 'last': last name} 
if age: 
person['age'] = age 
return person 


musician = build person('jimi', 'hendrix', age=27) 
print (musician) 


在 函数 定义 中 ， 我 们 新 增 了 一 个 可 选 形 参 age， 并 将 其 默认 值 设置 为 空 字符 串 。 如 果 函 数 调 
用 中 包含 这 个 形 参 的 值 ， 这 个 值 将 存储 到 字典 中 。 在 任何 情况 下 ， 这 个 函数 都 会 存储 人 的 姓名 ， 
但 可 对 其 进行 修改 ， 使 其 也 存储 有 关 人 的 其 他 信息 。 


8.3.4 结合 使 用 函数 和 while 循环 


可 将 函数 同 本 书 前面 介 绍 的 任何 Python 结构 结合 起 来 使 用 。 例 如 ， 下 面 将 结合 使 用 函数 
get_formatted_name() 和 while 循 环 ， 以 更 正规 的 方式 问候 用 户 。 下 面 尝试 使 用 名 和 姓 跟 用 户 打 
招呼 : 


greeter.py 


def get formatted name(first name, last name): 
" "返回 整洁 的 姓名 """ 
full name = first name + ' ' + last name 
return full name.title() 


# 这 是 一 个 无 限 循 环 ! 
while True: 
0 print("\nplease tell me your name:") 
f name = input("First name: ") 
1] name = input("Last name: ") 


formatted name = get formatted name(f name, 1 name) 
print("\nHello, " + formatted name + "!") 


在 这 个 示例 中 ,我 们 使 用 的 是 get_formatted_name() 的 简单 版 本 ,不 涉及 中 间 名 ,其 中 的 while 
循环 让 用 户 输入 姓名 : 依次 提示 用 户 输入 名 和 姓 ( 见 @ )。 

但 这 个 while 循 环 存在 一 个 问题 : 没有 定义 退出 条 件 。 请 用 户 提 供 一 系列 输入 时 ， 该 在 什么 
地 方 提供 退出 条 件 呢 ? 我 们 要 让 用 户 能 够 尽 可 能 容易 地 退出 ,因此 每 次 提示 用 户 输入 时 , 都 应 提 
供 退出 途径 。 每 次 提示 用 户 输入 时 ， 都 使 用 break 语 名 提供 了 退出 循环 的 简单 途径 : 


def get formatted name(first name, last name): 
整洁 的 姓名 """ 
full name = first name + ' ' + last name 
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return full name.title() 


while True: 
print("\nplease tell me your name:") 
print("(enter 'q' at any time to quit)") 


F_ name = input("First name: ") 


if f name == 'q : 
break 


] name = input("Last name: ") 


if 1 name == 'q': 
break 


Formatted name = get formatted name(f name, 1 name) 
print("\nHello, " + formatted name + "!") 


否 


为 止 : 


我 们 添加 了 一 条 消息 来 告诉 用 户 如 何 退 出 , 然后 在 每 次 提示 用 户 输入 时 , 都 检查 他 输入 的 是 
退出 值 , 如 果 是 , 就 退出 循环 。 现在, 这 个 程序 将 不 断 地 问候 ,直到 用 户 输入 的 姓 或 名 为 'q' sl 


Please tell me your name: 

enter 'q' at any time to quit) 
First name: eric 

Last name: matthes 


Hello, Eric Matthes! 


Please tell me your name: 
enter 'q' at any time to quit) 
First name: q 


动手 试 一 斌 
8-6 城市 名 : 编写 一 个 名 为 city_country() 的 函数 ， 它 接受 城市 的 名 称 及 其 所 属 的 
国家 。 这 个 函数 应 返回 一 个 格式 类 似 于 下 面 这 样 的 字符 串 : 


"Santiago, Chile" 


至 少 使 用 三 个 城市 -国家 对 调用 这 个 函数 ， 并 打印 它 返 回 的 值 。 

8-7 专辑 : 编写 一 个 名 为 make album() 的 函数 ， 它 创建 一 个 描述 音乐 专辑 的 字典 。 
这 个 函数 应 接受 歌手 的 名 字 和 专辑 名 ,并 返回 一 个 包含 这 两 项 信息 的 字典 。 使 用 这 个 函 
数 创 建 三 个 表示 不 同 专辑 的 字典 ,并 打印 每 个 返回 的 值 ， 以 核实 字典 正确 地 存储 了 专辑 
的 信息 。 

给 函数 make album() 添 加 一 个 可 选 形 参 , 以便 能 够 存储 专辑 包含 的 歌曲 数 。 如 果 调 
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用 这 个 子 数 时 指定 了 歌曲 数 ， 就 将 这 个 值 添加 到 表示 专辑 的 字典 中 。 调 用 这 个 子 数 ， 并 
至 少 在 一 次 调用 中 指定 专辑 包含 的 歌曲 数 。 

8-8 用 户 的 专辑 : 在 为 完成 练习 8-7 编写 的 程序 中 ， 编 写 一 个 while 循环 ， 让 用 户 
输入 一 个 专辑 的 歌手 和 名 称 。 获 取 这 些 信息 后 , 使 用 它们 来 调用 函数 make album()， 并 
将 创建 的 字典 打印 出 来 。 在 这 个 while 循环 中 ， 务必 要 提供 退出 途径 。 


8.4 传递 列表 


你 经 常会 发 现 ， 向 函数 传递 列表 很 有 用 ， 这 种 列表 包含 的 可 能 是 名 字 、 数 字 或 更 复杂 的 对 
象 (如 字典 )。 将 列表 传递 给 函数 后 ， 函 数 就 能 直接 访问 其 内 容 。 下 面 使 用 函数 来 提高 处 理 列表 
的 效率 。 

假设 有 一 个 用 户 列 表 , 我 们 要 问候 其 中 的 每 位 有 用户。 下面 的 示例 将 一 个 名 字 列 表 传 递 给 一 个 
名 为 greet_users() 的 函数 ， 这 个 函数 问候 列表 中 的 每 个 人 : 


greet users.py 


def greet users(names): 
""" 向 列表 中 的 每 位 用 户 都 发 出 简单 的 问候 """ 
for name in names: 
msg = "Hello, " + name.title() + "!" 
print(msg) 


@ usernames = ['hannah', 'ty', 'margot'] 
greet users(usernames) 


我 们 将 greet_users() 定 义 成 接受 一 个 名 字 列 表 , 并 将 其 存储 在 形 参 names 中 。 这 个 函数 遍历 收 到 
的 列表 , 并 对 其 中 的 每 位 用 户 都 打印 一 条 问候 语 。 在 @ 处 , 我 们 定义 了 一 个 用 户 列表 一 一 usernames， 
然后 调用 greet_users() ， 并 将 这 个 列表 传递 给 它 : 


Hello, Hannah! 
Hello, Ty! 
Hello, Margot! 


输出 完全 符合 预期 , 每 位 用 户 都 看 到 了 一 条 个 性 化 的 问候 语 。 每 当 你 要 问候 一 组 用 户 时 ,都 
可 调用 这 个 函数 。 


8.4.1 在 函数 中 修改 列表 
将 列表 传递 给 函数 后 ， 函 数 就 可 对 其 进行 修改 。 在 函数 中 对 这 个 列表 所 做 的 任何 修改 都 是 永 
入 性 的 ， 这 让 你 能 够 高 效 地 处 理 大 量 的 数据 。 


来 看 一 家 为 用 户 提交 的 设计 制作 3D 打 印 模型 的 公司 。 需 要 打印 的 设计 存储 在 一 个 列表 中 ， 
打印 后 移 到 另 一 个 列表 中 。 下 面 是 在 不 使 用 函数 的 情况 下 模拟 这 个 过 程 的 代码 : 
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printing_models.py 


# 首先 创建 一 个 列表 ， 其 中 外 包含 一 些 要 打印 的 设计 
unprinted designs = [ "iphone case', 'robot pendant', 'dodecahedron'] 
completed models = [] 


# 模拟 打印 每 个 设计 ， 直 到 没有 未 打印 的 设计 为 止 
# 打印 每 个 设计 后 ， 施 将 其 移 到 列表 completed models 中 
while unprinted designs: 

current design = unprinted designs.pop() 


模拟 根据 设计 制作 3D 打 印 模型 的 过 程 
print("Printing model: " + current design) 
completed models.append(current design) 


# 显示 打印 好 的 所 有 模型 

print("\nThe following models have been printed:") 
for completed model in completed models: 
print(completed model) 


这 个 程序 首先 创建 一 个 需要 打印 的 设计 列表 ， 还 创建 一 个 名 为 completed_models 的 空 列表 ， 8 
人 设计 打印 都 将 移 到 这 个 列表 中 。 EE designs 中 还 有 设计 ，while 循 环 就 模拟 
aa 从 该 列表 末尾 删除 一 个 设计 ， 将 其 存储 到 变量 current_design 中 ， 并 显示 一 条 
消息 ， 指 出 正在 打印 当前 的 设计 ， 再 将 aa models 中 。 循 环 结束 后 ， 显 
示 已 打印 的 所 有 设计 : 


Printing model: dodecahedron 
Printing model: robot pendant 
Printing model: iphone case 


The following models have been printed: 
dodecahedron 

robot pendant 

iphone case 


为 重新 组 织 这 些 代 码 ， 我 们 可 编写 两 个 函数 ， 每 个 都 做 一 件 具体 的 工作 。 大 部 分 代码 都 与 
原来 相同 ， 只 是 效率 更 高 。 第 一 个 函数 将 负责 处 理 打印 设计 的 工作 ， 而 第 二 个 将 概述 打印 了 哪 
些 设 计 : 


@ def print models(unprinted designs, completed models) 
模拟 打印 每 个 设计 ， 直 到 没有 未 打印 的 设计 为 止 
打印 每 个 设计 后 ， 都 将 其 移 到 列表 completed models 中 
while unprinted designs: 
current design = unprinted designs.pop() 


# 模拟 根据 设计 制作 3D 打 印 模 型 的 过 程 
print("Printing model: " + current design) 
completed models.append(current design) 
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@ def show completed models(completed models): 
"" "显示 打印 好 的 所 有 模型 """ 
print("\nThe following models have been printed:") 
for completed model in completed models: 
print(completed model) 


unprinted designs = ['iphone case', 'robot pendant', 'dodecahedron'] 
completed models = [] 


print models(unprinted designs, completed models) 
show completed models(completed models) 


在 @ 处 ,我 们 定义 了 函数 print_models()， 它 包含 两 个 形 参 : 一 个 需要 打印 的 设计 列表 和 一 
个 打印 好 的 模型 列表 。 给 定 这 两 个 列表 ,这 个 函数 模拟 打印 每 个 设计 的 过 程 : 将 设计 逐个 地 从 未 
打印 的 设计 列表 中 取出 ， 并 加 入 到 打印 好 的 模型 列表 中 。 在 @ 人 处 ， 我们 定义 了 函数 


数 


show_completed models() ， 它 包含 一 个 形 参 : 打印 好 的 模型 列表 。 给 定 这 个 列表 ， 郴 
show_completed_models() 显 示 打 印 出 来 的 每 个 模型 的 名 称 。 

这 个 程序 的 输出 与 未 使 用 函数 的 版 本 相同 , 但 组 织 更 为 有 序 。 完 成 大 部 分 工作 的 代码 都 移 到 
了 两 个 函数 中 , 让 主 程序 更 容易 理解 。 只 要 看 看 主 程序 , 你 就 知道 这 个 程序 的 功能 容易 看 清 得 多 : 


unprinted designs = ['iphone case', 'robot pendant', 'dodecahedron'] 
completed models = [] 


print models(unprinted designs, completed models) 
show completed models(completed models) 


我 们 创建 了 一 个 未 打印 的 设计 列表 , 还 创建 了 一 个 空 列表 , 用 于 存储 打印 好 的 模型 。 接 下 来 ， 
由 于 我 们 已 经 定义 了 两 个 函数 ， 因 此 只 需 调用 它们 并 传 入 正确 的 实 参 即 可 。 我 们 调用 
print_models() 并 向 它 传递 两 个 列表 ; 像 预 期 的 一 样 ，print_models() 模 拟 打 印 设计 的 过 程 。 接 
下 来 ,我 们 调用 show_completed_models(), 并 将 打印 好 的 模型 列表 传递 给 它 ， 让 其 能 够 指出 打印 
了 哪些 模型 。 描 述 性 的 函数 名 让 别人 阅读 这 些 代码 时 也 能 明白 ,虽然 其 中 没有 任何 注释 。 

相 比 于 没有 使 用 函数 的 版 本 ， 这 个 程序 更 容易 扩展 和 维护 。 如 果 以 后 需要 打印 其 他 设计 ， 
只 需 再 次 调用 print_models() 即 可 。 如 果 我 们 发 现 需要 对 打印 代码 进行 修改 , 只 需 修改 这 些 代码 
一 次 ， 就 能 影响 所 有 调用 该 函数 的 地 方 ; 与 必须 分 别 修改 程序 的 多 个 地 方 相 比 ， 这 种 修改 的 效 

这 个 程序 还 演示 了 这 样 一 种 理念 , 即 每 个 函数 都 应 只 负责 一 项 具体 的 工作 。 第 一 个 函数 打印 
每 个 设计 ,而 第 二 个 显示 打印 好 的 模型 ; 这 优 于 使 用 一 个 函数 来 完成 两 项 工作 。 编写 函数 时 ， 如 
果 你 发 现 它 执行 的 任务 太 多 , 请 尝试 将 这 些 代 码 划分 到 两 个 函数 中 。 别 忘 了 ,总 是 可 以 在 一 个 函 
数 中 调用 另 一 个 函数 ， 这 有 助 于 将 复杂 的 任务 划分 成 一 系列 的 步骤 。 
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8.4.2 禁止 函数 修改 列表 


有 时 候 , 需要 禁止 函数 修改 列表 。 例 如, 假设 像 前 一 个 示例 那样 ,你 有 一 个 未 打印 的 设计 列 
表 , 并 编写 了 一 个 将 这 些 设计 移 到 打印 好 的 模型 列表 中 的 函数 。 你 可 能 会 做 出 这 样 的 决定 : 即便 
打印 所 有 设计 后 ,也 要 保留 原来 的 未 打印 的 设计 列表 ,以 供 备案 。 但 由 于 你 将 所 有 的 设计 都 移出 
了 unprinted_ designs， 这 个 列表 变 成 了 空 的 ， 原 来 的 列表 没有 了 。 为 解决 这 个 问题 ， 可 向 函数 传 
递 列表 的 副本 而 不 是 原件 ; 这 样 函 数 所 做 的 任何 修改 都 只 影响 副本 ， 而 丝毫 不 影响 原件 。 
要 将 列表 的 副本 传递 给 函数 ， 可 以 像 下 面 这 样 做 : 


function name( 1ist namel:]) 


切片 表示 法 [:] 创 建 列表 的 副本 。 在 print_ models.py 中 ， 如 果 不 想 清空 未 打印 的 设计 列表 ， 
可 像 下 面 这 样 调用 print_models(): 


print models(unprinted designs[:], completed models) 


这 样 函数 print_models() 依 然 能 够 完成 其 工作 ， 因 为 它 获得 了 所 有 未 打印 的 设计 的 名 称 ， 但 
它 使 用 的 是 列表 unprinted_designs 的 副本 , 而 不 是 列表 unprinted_designs 本 身 。 像 以 前 一 样 , 列 
表 completed_models 也 将 包含 打印 好 的 模型 的 名 称 ， 但 函数 所 做 的 修改 不 会 影响 到 列表 
unprinted designs。 

虽然 向 函数 传递 列表 的 副本 可 保留 原始 列表 的 内 容 , 但 除非 有 充分 的 理由 需要 传递 副本 , 否 
w ot 从 函数 ,因为 让 函数 使 用 现成 列表 可 避免 花 时 间 和 内 存 创建 副本 ,从 

提高 效率 ， 在 处 理 大 型 列表 时 尤其 如 此 。 


动手 试 一 斌 
8-9 魔术 师 : 创建 一 个 包含 魔术 师 名 字 的 列表 ， 并 将 其 传递 给 一 个 名 为 
show magicians() 的 函数 ， 这 个 函数 打印 列表 中 每 个 魔术 师 的 名 字 。 
8-10 了 不 起 的 魔术 师 : 在 你 为 完成 练习 8-9 而 编写 的 程序 中 ， 编 写 一 个 名 为 
make great() 的 函数 ， 对 魔术 师 列表 进行 修改 ， 在 每 个 魔术 师 的 名 字 中 都 加 入 字样 “the 


Great”。 调 用 函数 show magicians()， 确 认 魔 术 师 列表 确实 变 了 。 

8-11 不 变 的 魔术 师 : 修改 你 为 完成 练习 8-10 而 编写 的 程序 ， 在 调用 函数 
make great() 时 ,向 它 传递 魔术 师 列表 的 副本 。 由 于 不 想 修改 原始 列表 , 请 返回 修改 后 
的 列表 ， 并 将 其 存储 到 另 一 个 列表 中 。 分 别 使 用 这 两 个 列表 来 调用 show magicians()， 
确认 一 个 列表 包含 的 是 原来 的 魔术 师 名 字 ， 而 另 一 个 列表 包含 的 是 添加 了 字样 “the 
Great” 的 魔术 师 名 字 。 
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8.5 传递 任意 数量 的 实 参 

有 时 候 ， 你 预先 不 知道 机 数 需要 接受 多 少 个 实 参 ,， 好 在 Python 人 允许 函数 从 调用 语句 中 收集 任 
意 数量 的 实 参 。 

例如 , 来 看 一 个 制作 比萨 的 郴 数 ， 它 需要 接受 很 多 配料 ,但 你 无 法 预先 确定 顾客 要 多 少 种 配 
料 。 下 面 的 函数 只 有 一 个 形 参 #toppings， 但 不 管 调 用 语句 提供 了 多 少 实 参 ， 这 个 形 参 都 将 它们 
统统 收入 寺中 : 

pizza.py 


def make pizza(*toppings): 
"" "打印 顾客 点 的 所 有 配料 """ 
print(toppings) 


make pizza('pepperoni') 
make_pizza('mushrooms', 'green peppers', 'extra cheese ') 


形 参 名 *toppings 中 的 星 号 让 Python 创 建 一 个 名 为 toppings 的 空 元 组 , 并 将 收 到 的 所 有 值 都 封 
装 到 这 个 元 组 中 。 函 数 体内 的 print 语 句 通 过 生成 输出 来 证 明 Python 能 够 处 理 使 用 一 个 值 调用 也 
数 的 情形 ， 也 能 处 理 使 用 三 个 值 来 调用 函数 的 情形 。 它 以 类 似 的 方式 处 理 不 同 的 调用 ， 注 意 ， 
Python 将 实 参 封装 到 一 个 元 组 中 ， 即 便 函 数 只 收 到 一 个 值 也 如 此 : 


("pepperoni',) 
('mushrooms', 'green peppers', 'extra cheese') 


现在 ， 我 们 可 以 将 这 条 print 语 名 替换 为 一 个 循环 ， 对 配料 列表 进行 遍历 ， 并 对 顾客 点 的 比 
了 萨 进行 描述 : 


def make pizza(*toppings) 
""" 概 述 妥 制作 的 比萨 """ 
print("\nMaking a pizza with the following toppings:") 
for topping in toppings: 
print("- " + topping) 


make _pizza( "pepperoni ) 
make _ pizza( mushrooms " ， 'green peppers', 'extra cheese') 


不 管 收 到 的 是 一 个 值 还 是 三 个 值 ， 这 个 函数 都 能 妥善 地 处 理 : 


Making a pizza with the following toppings: 
- pepperoni 


Making a pizza with the following toppings: 
- mushrooms 

- green peppers 

- extra cheese 


不 管 函 数 收 到 的 实 参 是 多 少 个 ， 这 种 语法 都 管用 。 
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8.5.1 结合 使 用 位 置 实 参 和 任意 数量 实 参 


如 果 要 让 函数 接受 不 同类 型 的 实 参 ， 必 须 在 函数 定义 中 将 接纳 任意 数量 实 参 的 形 参 放 在 最 
后 。Python 先 匹配 位 置 实 参 和 关键 字 实 参 ， 表 将 余下 的 实 参 都 收集 到 最 后 一 个 形 参 中 。 

例如 ， 如 果 前 面 的 函数 还 需要 一 个 表示 比萨 尺寸 的 实 参 ， 必 须 将 该 形 参 放 在 形 参 *toppings 
的 前 面 : 


def make pizza(size, *toppings): 
"" "概述 要 制作 的 比萨 "" 
print("\nMaking a " + str(size) + 
"-inch pizza with the following toppings:") 
for topping in toppings: 
print("- " + topping) 


make pizza(16, 'pepperoni') 
make_ pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 


基于 上 述 函 数 定义 ,Python 将 收 到 的 第 一 个 值 存储 在 形 参 size 中 ， 并 将 其 他 的 所 有 值 都 存储 
在 元 组 toppings 中 。 在 函数 调用 中 ， 首 先 指 定 表示 比萨 尺寸 的 实 参 ,然后 根据 需要 指定 任意 数量 
的 配料 。 

现在 , 每 个 比萨 都 有 了 尺寸 和 一 系列 配料 , 这 些 信息 按 正 确 的 顺序 打印 出 来 了 一 一 首先 是 尺 
寸 ， 然 后 是 配料 : 


Making a 16-inch pizza with the following toppings : 
- pepperoni 


Making a 12-inch pizza with the following toppings: 
- mushrooms 

- green peppers 

- extra cheese 


8.5.2 ”使 用 任意 数量 的 关键 字 实 参 


有 时 候 , 需要 接受 任意 数量 的 实 参 , 但 预先 不 知道 传递 给 函数 的 会 是 什么 样 的 信息 。 在 这 种 
情况 下 ， 可 将 函数 编写 成 能 够 接受 任意 数量 的 键 - 值 对 一 一 调用 语句 提供 了 多 少 就 接受 多 少 。 一 
个 这 样 的 示例 是 创建 用 户 简介 : 你 知道 你 将 收 到 有 关 用 户 的 信息 ， 但 不 确定 会 是 什么 样 的 信息 。 
在 下 面 的 示例 中 ， 隐 数 build_profile() 接 受 名 和 姓 ， 同 时 还 接受 任意 数量 的 关键 字 实 参 : 


user_profile.py 


def build profile(first, last, **user info): 
"" "创建 一 个 字典 ， 其 中 包含 我 们 知道 的 有 关 用 户 的 一 切 """ 
profile = {} 
@ profile['first name'] = first 
profile['last name'] = last 
© for key, value in user info.items(): 
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profile[key] = value 
return profile 


user profile = build profile('albert', 'einstein', 
location='princeton', 
field="'physics') 
print(user profile) 


函数 build profile() 的 定义 要 求 提 供 名 和 姓 ， 同 时 允许 用 户 根 据 需 要 提供 任意 数量 的 名 称 - 
值 对 。 形 参 ##user info 中 的 两 个 星 号 让 Python 创建 一 个 名 为 user info 的 空 字典 ， 并 将 收 到 的 所 
有 和 名称- 值 对 都 封装 到 这 个 字典 中 。 在 这 个 函数 中 ,可 以 像 访问 其 他 字典 那样 访问 user_info 中 的 
名 称 - 值 对 。 

在 build_profile() 的 函数 体内 , 我 们 创建 了 一 个 名 为 profile 的 空 字典 , 用 于 存储 用 户 简介 。 
在 @ 处 , 我 们 将 名 和 姓 加 入 到 这 个 字典 中 , 因为 我 们 总 是 会 从 用 户 那 里 收 到 这 两 项 信息 。 在 @ 处 ， 
我 们 遍历 字典 user info 中 的 键 - 值 对 ， 并 将 每 个 键 - 值 对 都 加 入 到 字典 profile 中 。 最 后 ， 我 们 将 
字典 profile 返 回 给 函数 调用 行 。 

我 们 调用 build profile() ， 向 它 传递 名 ( 'albert' )、 姓 ( 'einstein' ) 和 两 个 键 - 值 对 
(location='princeton' 和 field='physics' )， 并 将 返回 的 profile 存 储 在 变量 user profile 中 ， 再 
打印 这 个 变量 : 


{'first name': 'albert', 'last name': 'einstein', 
‘location': 'princeton', 'field': 'physics'} 


在 这 里 ,返回 的 字典 包含 用 户 的 名 和 姓 , 还 有 求学 的 地 方 和 所 学 专业 。 调 用 这 个 函数 时 , 不 
管 额外 提供 了 多 少 个 键 - 值 对 ， 它 都 能 正确 地 处 理 。 
局 写 函 数 时 ， 你 可 以 以 各 种 方式 混合 使 用 位 置 实 参 、 关 键 字 实 参 和 任意 数量 的 实 参 。 知 道 这 
些 实 参 类 型 大 有 神 益 , 因为 阅读 别人 编写 的 代码 时 经 常会 见 到 它们 。 要 正确 地 使 用 这 些 类 型 的 实 
参 并 知道 它们 的 使 用 时 机 , 需要 经 过 一 定 的 练习 。 就 目前 而 言 , 牢记 使 用 最 简单 的 方法 来 完成 任 
务 就 好 了 。 你 继续 往 下 阅读 ， 就 会 知道 在 各 种 情况 下 哪 种 方法 的 效率 是 最 高 的 。 


NS 
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8-12 三 明治 : 编写 一 个 函数 ， 它 接受 顾客 要 在 三 明治 中 添加 的 一 系列 食材 。 这 个 
函数 只 有 一 个 形 参 〈 它 收 集 函 数 调用 中 提供 的 所 有 食材 )， 并 打印 一 条 消息 ， 对 顾客 点 
的 三 明治 进行 概述 。 调 用 这 个 函数 三 次 ， 每 次 都 提供 不 同 数量 的 实 参 。 

8-13 用 户 简介 : 复制 前 面 的 程序 user profile.py， 在 其 中 调用 build profile() 来 
创建 有 关 你 的 简介 ; 调用 这 个 函数 时 ， 指 定 你 的 名 和 姓 ， 以 及 三 个 描述 你 的 键 - 值 对 。 

8-14 汽车 : 编写 一 个 函数 ， 将 一 辆 汽车 的 信息 存储 在 一 个 字典 中 。 这 个 函数 总 是 接 
受制 造 商 和 型 号 ， 还 接受 任意 数量 的 关键 字 实 参 。 这 样 调用 这 个 函数 : 提供 必 不 可 少 的 
信息 ， 以 及 两 个 名 称 - 值 对 ， 如 颜色 和 选 装配 件 。 这 个 函数 必须 能 够 像 下 面 这 样 进 行 调 用 : 
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car = make car('subaru', 'outback', color='blue', tow package=True) 


打印 返回 的 字典 ， 确 认 正 确 地 处 理 了 所 有 的 信息 。 


8.6 将 函数 存储 在 模块 中 


函数 的 优点 之 一 是 ,使 用 它们 可 将 代码 块 与 主 程序 分 离 。 通 过 给 函数 指定 描述 性 名 称 ， 可 让 
主 程序 容易 理解 得 多 。 你 还 可 以 更 进一步 , 将 函数 存储 在 被 称 为 模块 的 独立 文件 中 ,再 将 模块 寻 
入 到 主 程序 中 。import 语 句 允 许 在 当前 运行 的 程序 文件 中 使 用 模块 中 的 代码 。 
通过 将 函数 存储 在 独立 的 文件 中 ， 可 隐藏 程序 代码 的 细节 ， 将 重点 放 在 程序 的 高 层 逻 辑 上 。 
这 还 能 让 你 在 众多 不 同 的 程序 中 重用 函数 。 将 函数 存储 在 独立 文件 中 后 , 可 与 其 他 程序 员 共享 这 
些 文件 而 不 是 整个 程序 。 知 道 如 何 导 入 函数 还 能 让 你 使 用 其 他 程序 员 编 写 的 函数 库 。 

导入 模块 的 方法 有 多 种 ， 下 面 对 每 种 都 作 简 要 的 介绍 。 


8.6.1 导入 整个 模块 


要 让 函数 是 可 导入 的 ， 得 先 创 建 模块 。 模 块 是 扩展 名 为 .py 的 文件 ， 包 含 要 导入 到 程序 中 的 
代码 。 下 面 来 创建 一 个 包含 函数 make_ pizza() 的 模块 。 为 此 ， 我 们 将 文件 pizza.py 中 除 函 数 
make_pizza() 之 外 的 其 他 代码 都 删除 : 


pizza.py 


def make pizza(size, *toppings): 
"" "概述 要 制作 的 比萨 """ 
print("\nMaking a " + str(size) + 
"-inch pizza with the following toppings:") 
for topping in toppings: 
print("- " + topping) 


接 下 来 ， 我 们 在 pizza.py 所 在 的 目录 中 创建 另 一 个 名 为 making pizzas.py 的 文件 ， 这 个 文件 导 
人 刚 创 建 的 模块 ， 再 调用 make_pizza() 两 次 : 


making_pizzas.py 


import pizza 


@ pizza.make pizza(16, 'pepperoni') 
pizza.make pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 


Python 读 取 这 个 文件 时 ， 代 码 行 import pizzaik 上 Python 打开 文 件 pizza.py， 并 将 其 中 的 所 有 活 
数 都 复制 到 这 个 程序 中 。 你 看 不 到 复制 的 代码 ， 因 为 这 个 程序 运行 时 ，Python 在 幕后 复制 这 些 代 
人 码 。 你 只 需 知 道 ， 在 making pizzas.py 中 ， 可 以 使 用 pizza.py 中 定义 的 所 有 函数 。 
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要 调用 被 导入 的 模块 中 的 函数 , 可 指定 导入 的 模块 的 名 称 pizza 和 函数 名 make_pizza(), 并 用 
句点 分 隔 它 们 ( 见 @ )。 这 些 代码 的 输出 与 没有 导入 模块 的 原始 程序 相同 : 


Making a 16-inch pizza with the following toppings: 
- pepperoni 


Making a 12-inch pizza with the following toppings: 
- mushrooms 

- green peppers 

- extra cheese 


这 就 是 一 种 导入 方法 : 只 需 编 写 一 条 import 语 句 并 在 其 中 指定 模块 名 ,就 可 在 程序 中 使 用 该 


模块 中 的 所 有 函数 。 如 果 你 使 用 这 种 import 语 句 导 入 了 名 为 module_name.py 的 整个 模块 ， 就 可 使 
用 下 面 的 语法 来 使 用 其 中 任何 一 个 函数 : 


Mmodule name. function name() 


8.6.2 ”导入 特定 的 函数 
你 还 可 以 导入 模块 中 的 特定 函数 ， 这 种 导入 方法 的 语法 如 下 : 


from module name import function name 


通过 用 逗号 分 隔 函 数 名 ， 可 根据 需要 从 模块 中 导入 任意 数量 的 函数 : 


from module name import function 0, function 1, function 2 


对 于 前 面 的 making_pizzas.py 示 例 ， 如 果 只 想 导 入 要 使 用 的 函数 ， 代 码 将 类 似 于 下 面 这 样 : 


from pizza import make pizza 


make pizza(16, 'pepperoni') 
make pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 


车 使 用 这 种 语法 ,调用 函数 时 就 无 需 使 用 句点 。 由 于 我 们 在 import 语 句 中 显 式 地 导入 了 函数 
make_pizza()， 因 此 调用 它 时 只 需 指 定 其 名 称 。 


8.6.3 使 用 as 给 函数 指定 别名 


如 果 要 导入 的 函数 的 名 称 可 能 与 程序 中 现 有 的 名 称 冲突 , 或 者 函数 的 名 称 太 长 ,可 指定 简短 
而 独一无二 的 别名 一 一 函数 的 另 一 个 名 称 ， 类 似 于 外 号 。 要 给 函数 指定 这 种 特殊 外 号 ， 需 要 在 导 
入 它 时 这 样 做 。 

下 面 给 函数 make_pizza() 指 定 了 别名 mp()。 这 是 在 import 语 句 中 使 用 make_pizza as mp 实现 的 ， 
关键 字 as 将 函数 重 命名 为 你 提供 的 别名 : 
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from pizza import make pizza as mp 


mp(16, "pepperoni ' ) 

mp(12, 'mushrooms', "green peppers', "extTa cheese') 

上 面 的 import 语 句 将 函数 make_pizza() 重 命名 为 mp(); 在 这 个 程序 中 ， 每 当 需 要 调用 
make_pizza() 时 ,都 可 简写 成 mp() ， 而 Python 将 运行 nake_pizza() 中 的 代码 , 这 可 避免 与 这 个 程序 
可 能 包含 的 函数 make_pizza() 混 消 。 

指定 别名 的 通用 语法 如 下 : 


from module name import function name as fn 


8.6.4 使 用 as 给 模块 指定 别名 


你 还 可 以 给 模块 指定 别名 。 通 过 给 模块 指定 简短 的 别名 ( 如 给 模块 pizza 指 定 别 名 p )， 让 你 
能 够 更 轻松 地 调用 模块 中 的 函数 。 相 比 于 pizza.make_pizza()，p.make_pizza() 更 为 简洁 : 


import pizza as p 


p.make pizza(16, 'pepperoni') 

p.make pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 

上 述 import 语 句 给 模块 pizza 指 定 了 别名 p， 但 该 模块 中 所 有 函数 的 名 称 都 没 变 。 调 用 函数 
make_pizza() 时 ,可 编写 代码 p.make_pizza() 而 不 是 pizza.make_pizza(), 这 样 不 仅 能 使 代码 更 简 
洁 ,还 可 以 让 你 不 再 关注 模块 名 ， 而 专注 于 描述 性 的 函数 名 。 这 些 函 数 名 明确 地 指出 了 函数 的 功 
， 对 理解 代码 而 言 ， 它 们 比 模块 名 更 重要 。 

给 模块 指定 别名 的 通用 语法 如 下 : 


车 
QH 


Fanny 
CC 


import modULe name 35 mn 


8.6.5 ”导入 模块 中 的 所 有 函数 
使 用 星 号 (* ) 运算 符 可 让 Python 导入 模块 中 的 所 有 函数 : 


from pizza import * 


make pizza(16, 'pepperoni') 

make_ pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 

import 语 句 中 的 星 号 让 Python 将 模块 pizza 中 的 每 个 函数 都 复制 到 这 个 程序 文件 中 。 由 于 导入 
了 每 个 函数 ,可 通过 名 称 来 调用 每 个 函数 ， 而 无 需 使 用 句点 表示 法 。 然 而 , 使 用 并 非 自 己 编写 的 
大 型 模块 时 , 最 好 不 要 采用 这 种 导入 方法 : 如 果 模 块 中 有 函数 的 名 称 与 你 的 项 目 中 使 用 的 名 称 相 
同 ， 可 能 导致 意 想不到 的 结果 : Python 可 能 遇 到 多 个 名 称 相同 的 函数 或 变量 ， 进 而 覆盖 函数 ， 而 
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+ 


是 分 别 导 和 所 有 的 函数 。 

最 佳 的 做 法 是 , 要 么 只 导入 你 需要 使 用 的 函数 , 要 么 导入 整个 模块 并 使 用 句点 表示 法 。 这 能 
让 代码 更 清晰 , 更 容易 阅读 和 理解 。 这 里 之 所 以 介绍 这 种 导入 方法 ,只 是 想 让 你 在 阅读 别人 编写 
的 代码 时 ， 如 果 遇 到 类 似 于 下 面 的 import 语 句 ， 能 够 理解 它们 : 


from module name import * 


8.7 了 通 数 编写 指南 


编写 函数 时 , 需要 牢记 几 个 细节 。 应 给 函数 指定 描述 性 名 称 ， 且 只 在 其 中 使 用 小 写字 母 和 下 
划 线 。 描 述 性 名 称 可 帮助 你 和 别人 明白 代码 想 要 做 什么 。 给 模块 命名 时 也 应 遵循 上 述 约定 。 

每 个 函数 都 应 包含 简要 地 阅 述 其 功能 的 注释 , 该 注释 应 紧 跟 在 函数 定义 后 面 , 并 采用 文档 字 
符 串 格式 。 文 档 良 好 的 函数 让 其 他 程序 员 只 需 阅 读 文档 字符 串 中 的 描述 就 能 够 使 用 它 : 他 们 完全 
可 以 相信 代码 如 描述 的 那样 运行 ; 只 要 知道 函数 的 名 称 、 需 要 的 实 参 以 及 返回 值 的 类 型 ,就 能 在 
自己 的 程序 中 使 用 它 。 

给 形 参 指定 默认 值 时 ， 等 号 两 边 不 要 有 空格 : 


def function name(parameter 0, parameter 1=" default value') 


对 于 函数 调用 中 的 关键 字 实 参 ， 也 应 遵循 这 种 约定 : 


function name( valuye 0, parameter 1= Value') 


PEP 8 ( https://www.python.org/dev/peps/pep-0008/ ) 建议 代码 行 的 长 度 不 要 超过 79 字 符 , 这 样 
只 要 编辑 器 窗口 适中 ， 就 能 看 到 整 行 代码 。 如 果 形 参 很 多 ， 导 致 函 数 定 义 的 长 度 超过 了 79 字 符 ， 
可 在 函数 定义 中 输入 左 括号 后 按 回 车 键 ， 并 在 下 一 行 按 两 次 Tab 键 ， 从 而 将 形 参 列表 和 只 缩 进 一 
层 的 函数 体 区 分 开 来 。 

大 多 数 编辑 器 都 会 自动 对 齐 后 续 参 数列 表 行 , 使 其 缩 进 程度 与 你 给 第 一 个 参数 列表 行 指定 的 
缩 进 程度 相同 : 


def function name( 
parameter 0, parameter 1, parameter 2, 
parameter 3, parameter 4, parameter 5): 
function body... 


如 果 程 序 或 模块 包含 多 个 函数 , 可 使 用 两 个 空 行将 相 邻 的 函数 分 开 , 这 样 将 更 容易 知道 前 一 
个 函数 在 什么 地 方 结束 ， 下 一 个 函数 从 什么 地 方 开 始 。 

所 有 的 import 语 句 都 应 放 在 文件 开头 ,唯一 例外 的 情形 是 ,在 文件 开头 使 用 了 注释 来 描述 整 
个 程序 。 
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8-15 打印 模型 : 将 示例 print models.py 中 的 函数 放 在 另 一 个 名 为 printing 
functions.py 的 文件 中 ; 在 print models.py 的 开头 编写 一 条 import 语句 ， 并 修改 这 个 文 
件 以 使 用 导入 的 函数 。 

8-16 导入 : 选择 一 个 你 编写 的 且 只 包含 一 个 函数 的 程序 ， 并 将 这 个 函数 放 在 另 一 
个 文件 中 。 在 主 程序 文件 中 ， 使 用 下 述 各 种 方法 导入 这 个 函数 ， 再 调用 它 : 


import module name 

from module name import function name 

from module name import function name as fn 
import module name as mn 

from module name import * 


8-17 函数 编写 指南 : 选择 你 在 本 章 中 编写 的 三 个 程序 ， 确 保 它们 遵循 了 本 节 介 绍 
的 函数 编写 指南 。 
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在 本 章 中 ,你 学 习 了 : 如 何 编写 函数 ， 以 及 如 何 传递 实 参 ,让 函数 能 够 访问 完成 其 工作 所 需 
的 信息 ; 如 何 使 用 位 置 实 参 和 关键 字 实 参 ， 以 及 如 何 接受 任意 数量 的 实 参 ; 显示 输出 的 函数 和 返 
回 值 的 函数 ;如 何 将 函数 同 列表 、 字 典 、if 语 句 和 while 循 环 结合 起 来 使 用 。 你 还 知道 了 如 何 将 
函数 存储 在 被 称 为 模块 的 独立 文件 中 ,让 程序 文件 更 简单 、 更 易于 理解 。 最 后 ,你 学 习 了 子 数 编 
写 指南 ， 遵 循 这 些 指南 可 让 程序 始终 结构 良好 ， 并 对 你 和 其 他 人 来 说 易于 阅读 。 


NS 


程序 员 的 目标 之 一 是 , 编写 简单 的 代码 来 完成 任务 ,而 函数 有 助 于 你 实现 这 样 的 目标 。 它 们 
让 你 编写 好 代码 块 并 确定 其 能 够 正确 运行 后 ,就 可 置之不理 ,确定 函数 能 够 正确 地 完成 其 工作 后 ， 


你 就 可 以 接着 投 喘 于 下 
函数 让 你 编写 代码 


个 编码 任务 。 
次 后 , 想 重 用 它们 多 少 次 就 重用 多 少 次 。 需 要 运行 函数 中 的 代码 时 ， 只 


需 编 写 一 行 函数 调用 代码 ,就 可 让 函数 完成 其 工作 。 需 要 修改 函数 的 行为 时 ， 只 需 修改 一 个 代码 
块 ， 而 所 做 的 修改 将 影响 调用 这 个 函数 的 每 个 地 方 。 


使 用 函数 让 程序 更 容易 阅读 , 而 良好 的 函数 名 概述 了 程序 各 个 部 分 的 作用 。 相 对 于 阅读 一 系 


列 的 代码 块 ， 阅 读 一 系列 函数 调用 让 你 能 够 更 快 地 明白 程序 的 作用 。 
函数 还 让 代码 更 容易 测试 和 调试 。 如 果 程 序 使 用 一 系列 的 函数 来 完成 其 任务 , 而 其 中 的 每 个 
函数 都 完成 一 项 具体 的 工作 ,测试 和 维护 起 来 将 容易 得 多 : 你 可 编写 分 别 调用 每 个 函数 的 程序 ， 


并 测试 每 个 函数 是 否 在 它 可 能 直到 的 各 种 情形 下 都 能 正确 地 运行 。 经 过 这 样 的 测试 后 你 就 能 信心 


满 满 ， 深 信 你 每 次 调用 这 些 函 数 时 ， 它 们 都 将 正确 地 运行 。 
在 第 9 章 ， 你 将 学 习 编 写 类 。 类 将 函数 和 数据 整洁 地 封装 起 来 ， 让 你 能 够 灵活 而 高 效 地 使 用 


它们 3 


类 


面向 对 象 编程 是 最 有 效 的 软件 编写 方法 之 一 。 在 面向 对 象 编程 中 ， 
编写 类 时 ， 你 定义 一 大 类 对 象 都 有 的 通用 行为 。 基 于 类 创建 对 象 时 ， 
每 个 对 象 都 自动 具备 这 种 通用 行为 ， 然 后 可 根据 需要 赋予 每 个 对 象 独 
特 的 个 性 。 使 用 面向 对 象 编程 可 模拟 现实 情景 ， 其 逼真 程度 达到 了 令 
你 惊讶 的 地 步 。 

根据 类 来 创建 对 象 被 称 为 实例 化 , 这 让 你 能 够 使 用 类 的 实例 。 在 
本 章 中 ,你 将 编写 一 些 类 并 创建 其 实例 。 你 将 指定 可 在 实例 中 存储 什 
么 信息 , 定义 可 对 这 些 实例 执行 哪些 操作 。 你 还 将 编写 一 些 类 来 扩展 
既 有 类 的 功能 ， 让 相似 的 类 能 够 高 效 地 共享 代码 。 你 将 把 自己 编写 的 类 存储 在 模块 中 ， 并 在 
自己 的 程序 文件 中 导入 其 他 程序 员 编 写 的 类 。 

理解 面向 对 象 编程 有 助 于 你 像 程序 员 那 样 看 世界 , 还 可 以 帮助 你 真正 明白 自己 编写 的 代 
码 : 不 仅 是 各 行 代码 的 作用 ,还 有 代码 背后 更 宏大 的 概念 。 了 解 类 背后 的 概念 可 培养 逻辑 思 
维 ， 让 你 能 够 通过 编写 程序 来 解决 遇 到 的 几乎 任何 问题 。 

随 着 面临 的 挑战 日 益 严 峻 ， 类 还 能 让 你 以 及 与 你 合作 的 其 他 程序 员 的 生活 更 轻松 。 如 果 
你 与 其 他 程序 员 基 于 同样 的 逻辑 来 编写 代码 ， 你 们 就 能 明白 对 方 所 做 的 工作 ; 你 编写 的 程序 
将 能 被 众多 合作 者 所 理解 ， 每 个 人 都 能 事 半 功 信 。 
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使 用 类 几乎 可 以 模拟 任何 东西 。 下 面 来 编写 一 个 表示 小 狗 的 简单 类 Dog 一 一 它 表示 的 不 是 特 
定 的 小 狗 ， 而 是 任何 小 狗 。 对 于 大 多 数 宠物 狗 ， 我 们 都 知道 些 什么 呢 ? 它 们 都 有 名 字 和 年 龄 ; 我 
们 还 知道 ， 大 多 数 小 狗 还 会 蹲 下 和 打 深 。 由 于 大 多 数 小 狗 都 具备 上 述 两 项 信息 ( 名 字 和 年 龄 ) 和 
两 种 行为 《足下 和 打滚 )， 我 们 的 Dog 类 将 包含 它们 。 这 个 类 让 Python 知道 如 何 创建 表示 小 狗 的 对 
象 。 编 写 这 个 类 后 ， 我 们 将 使 用 它 来 创建 表示 特定 小 狗 的 实例 。 
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9.1.1 创建 Dog 类 


根据 Dog 类 创建 的 每 个 实例 都 将 存储 名 字 和 年 龄 。 我 们 赋予 了 每 条 小 狗 蹲 下 (sit() ) 和 打滚 
(roll over() ) 的 能 力 : 


dog.py 


class Dog(): 
"一 次 模拟 小 狗 的 简单 尝试 """ 


def _init (self, name, age): 
"初始 化 属性 name 和 age”"" 
self.name = name 


self.age = age 


© © @oe 


(5) def sit(self): 
"" "模拟 小 狗 被 命令 时 足下 """ 


print(self.name.title() + " is now sitting.") 


def roll over(self): 
ID "模拟 小 狗 被 命令 时 打滚 " IT 
print(self.name.title() + " rolled over!") 


这 里 需要 注意 的 地 方 很 多 , 但 你 也 不 用 担心 , 本 章 充斥 着 这 样 的 结构 ,你 有 大 把 的 机 会 熟悉 
它 。 在 @ 处 , 我 们 定义 了 一 个 名 为 Dog 的 类 。 根据 约定 , 在 Python 中 , 首 字母 大 写 的 名 称 指 的 是 类 。 
这 个 类 定义 中 的 括号 是 空 的 ， 因 为 我 们 要 从 空白 创建 这 个 类 。 在 @ 处 , 我们 编写 了 一 个 文档 字符 
串 ， 对 这 个 类 的 功能 作 了 描述 。 

1. 方 法 init () 

类 中 的 函数 称 为 方法 ; 你 前 面 学 到 的 有 关 函 数 的 一 切 都 适用 于 方法 ,就 目前 而 言 ， 唯 一 重要 
的 差别 是 调用 方法 的 方式 。 @ 处 的 方法 _init () 是 一 个 特殊 的 方法 , 每 当 你 根据 Dog 类 创建 新 实 
例 时 ，Python 都 会 自动 运行 它 。 在 这 个 方法 的 名 称 中 ,开头 和 末尾 各 有 两 个 下 划 线 ， 这 是 一 种 约 
定 ， 旨 在 避免 Python 默认 方法 与 普通 方法 发 生 名 称 冲 突 。 

我 们 将 方法 _init () 定 义 成 了 包含 三 个 形 参 : self 、name 和 age。 在 这 个 方法 的 定义 中 , 形 
参 self 必 不 可 少 ， 还 必须 位 于 其 他 形 参 的 前 面 。 为 何必 须 在 方法 定义 中 包含 形 参 self 呢 ? 因为 
Python 调用 这 个 init () 方 法 来 创建 Dog 实例 时 , 将 自动 传人 实 参 self。 每 个 与 类 相关 联 的 方法 
调用 都 自动 传递 实 参 self， 它 是 一 个 指向 实例 本 身 的 引用 ， 让 实例 能 够 访问 类 中 的 属性 和 方法 。 
我 们 创建 bog 实例 时 ，Python 将 调用 Dog 类 的 方法 _init ()。 我 们 将 通过 实 参 向 Dog() 传 递 名 字 和 
年 龄 ; self 会 自动 传递 ， 因 此 我 们 不 需要 传递 它 。 每 当 我 们 根据 Dog 类 创建 实例 时 ， 都 只 需 给 最 
后 两 个 形 参 (name 和 age ) 提供 值 。 

@ 处 定义 的 两 个 变量 都 有 前 级 self。 以 self 为 前 缀 的 变量 都 可 供 类 中 的 所 有 方法 使 用 ， 我 们 
还 可 以 通过 类 的 任何 实例 来 访问 这 些 变 量 。self.name = name 获 取 存 储 在 形 参 name 中 的 值 ， 并 将 
其 存储 到 变量 name 中 ， 然 后 该 变量 被 关联 到 当前 创建 的 实例 。self.age = age 的 作用 与 此 类 似 。 
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像 这 样 可 通过 实例 访问 的 变量 称 为 属性 。 

Dog 类 还 定义 了 另外 两 个 方法 : sit() 和 roll over() ( 见 @ )。 由 于 这 些 方 法 不 需要 额外 的 信 
息 ， 如 名 字 或 年 龄 ， 因 此 它们 只 有 一 个 形 参 self。 我 们 后 面 将 创建 的 实例 能 够 访问 这 些 方法 , 换 
句 话说 , 它们 都 会 蹲 下 和 打滚 。 当 前 ，sit() 和 roll over() 所 做 的 有 限 ,它们 只 是 打印 一 条 消息 ， 
指出 小 狗 正 蹲 下 或 打滚 。 但 可 以 扩展 这 些 方 法 以 模拟 实际 情况 : 如 果 这 个 类 包含 在 一 个 计算 机 游 
戏 中 ， 这 些 方法 将 包含 创建 小 狗 足下 和 打滚 动画 效果 的 代码 。 如 果 这 个 类 是 用 于 控制 机 需 狗 的 ， 
这 些 方法 将 引导 机 器 狗 做 出 足下 和 打滚 的 动作 。 

2. 在 Python 2.7 中 创建 类 

在 Python 2.7 中 创建 类 时 ， 需 要 做 细微 的 修改 一 一 在 括号 内 包含 单词 opject: 


class C71assWame(object): 
-- Ship-- 


这 让 Python 2.7 类 的 行为 更 像 Python 3 类 ， 从 而 简化 了 你 的 工作 。 
在 Python 2.7 中 定义 Dog 类 时 ， 代 码 类 似 于 下 面 这 样 : 


class Dog(object): 
-- Ship-- 


9.1.2 ”根据 类 创建 实例 


可 将 类 视 为 有 关 如 何 创建 实例 的 说 明 。Dog 类 是 一 系列 说 明 ， 让 Python 知 道 如 何 创建 表示 特 
定 小 狗 的 实例 。 
下 面 来 创建 一 个 表示 特定 小 狗 的 实例 : 


class Dog(): 
Je ye 


@ my dog = Dog('willie', 6) 


@ print("My dog's name is "+ my dog.name.title() + ".") 
@ print("My dog is "+ str(my dog.age) + " years ol1d.") 


这 里 使 用 的 是 前 一 个 示例 中 编写 的 Dog 类 。 在 @ 处 ， 我 们 让 Python 创建 一 条 名 字 为 "willie'、 
年 龄 为 6 的 小 狗 。 遇 到 这 行 代码 时 ，Python 使 用 实 参 'willie' 和 6 调用 Dog 类 中 的 方法 _init_()。 
方法 _init_() 创 建 一 个 表示 特定 小 狗 的 示例 , 并 使 用 我 们 提供 的 值 来 设置 属性 name 和 age。 方法 
_init () 并 未 显 式 地 包含 return 语 句 ， 但 Python 自 动 返 回 一 个 表示 这 条 小 狗 的 实例 。 我 们 将 这 
个 实例 存储 在 变量 my_dog 中 。 在 这 里 , 命名 约定 很 有 用 : 我 们 通常 可 以 认为 首 字母 大 写 的 名 称 ( 如 
Dog ) 指 的 是 类 ， 而 小 写 的 名 称 ( 如 my_dog ) 指 的 是 根据 类 创建 的 实例 。 

1. 访问 属性 

要 访问 实例 的 属性 ， 可 使 用 句点 表示 法 。 在 @ 处 ， 我 们 编写 了 如 下 代码 来 访问 my_dog 的 属 


度 
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name 的 值 : 


my_dog.name 


句点 表示 法 在 Python 中 很 常用 ， 这 种 语法 演示 了 Python 如 何 获悉 属性 的 值 。 在 这 里 ，Python 
先 找 到 实例 my_ dog ， 再 查找 与 这 个 实例 相关 联 的 属性 name。 在 Dog 类 中 引用 这 个 属性 时 ， 使 用 的 
是 self.name。 在 四 处 ， 我 们 使 用 同样 的 方法 来 获取 属性 age 的 值 。 在 前 面 的 第 1 条 print 语 句 中 ， 
my_dog.name.title() 将 my_dog 的 属性 name 的 值 'willie' 改 为 首 字母 大 写 的 ; 在 第 2 条 print 语 句 中 ， 
str(my_dog.age) 将 my_dog 的 属性 age 的 值 6 转 换 为 字符 串 。 

输出 是 有 关 my_dog 的 摘要 : 


My dog's name is Willie. 
My dog is 6 years old. 


2. 调用 方法 
根据 Dog 类 创建 实例 后 ,就 可 以 使 用 句点 表示 法 来 调用 Dog 类 中 定义 的 任何 方法 。 下 面 来 让 小 
狗 蹲 下 和 打 演 : 


class Dog(): 


-- Ship-- 


my dog = Dog('willie', 6) 
my_dog.sit() 
my_dog.roll over() 


要 调用 方法 ， 可 指定 实例 的 名 称 ( 这 里 是 my_dog ) 和 要 调用 的 方法 ， 并 用 句点 分 隔 它们 。 遇 
到 代码 my_dog.sit() 时 , Python 在 类 Dog 中 查找 方法 sit() 并 运行 其 代码 。 Python 以 同样 的 方式 解读 
代码 my dog.roll over()。 

Willie 按 我 们 的 命令 做 了 : 


Willie is now sitting. 
Willie rolled over! 


这 种 语法 很 有 用 。 如 果 给 属性 和 方法 指定 了 合适 的 描述 性 名 称 ， 如 name 、age 、sit() 和 
roll_over()， 即 便 是 从 未 见 过 的 代码 块 ， 我 们 也 能 够 轻松 地 推断 出 它 是 做 什么 的 。 

3. 创建 多 个 实例 

可 按 需 求 根据 类 创建 任意 数量 的 实例 。 下 面 再 创建 一 个 名 为 your_dog 的 实例 : 


class Dog(): 


-- Snip-- 


my_dog = Dog('willie', 6) 
your dog = Dog('lucy', 3) 


print("My dog's name is " + my dog.name.title() + ".") 
print("My dog is "+ str(my dog.age) + " years ol1d.") 
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my_dog.sit() 


print("\nYour dog's name is "+ your dog.name.title() + ".") 
print("Your dog is " + str(your dog.age) + " years old.") 
your dog.sit() 


在 这 个 实例 中 ， 我 们 创建 了 两 条 小 狗 ， 它 们 分 别名 为 Willie 和 Lucy。 每 条 小 狗 都 是 一 个 独立 
的 实例 ， 有 自己 的 一 组 属性 ， 能 够 执行 相同 的 操作 : 


My dog's name is Willie. 
My dog is 6 years old. 
Willie is now sitting. 


Your dog's name is Lucy. 
Your dog is 3 years old. 
Lucy is now sitting. 


就 算 我 们 给 第 二 条 小 狗 指 定 同样 的 名 字 和 年 龄 ，Python 依 然 会 根据 Dog 类 创建 另 一 个 实例 。 
你 可 按 需 求 根据 一 个 类 创建 任意 数量 的 实例 , 条 件 是 将 每 个 实例 都 存储 在 不 同 的 变量 中 , 或 占用 
列表 或 字典 的 不 同位 置 。 


动手 试 一 斌 
9-1 餐馆 : 创建 一 个 名 为 Restaurant 的 类 ， 其 方法 init () 设 置 两 个 属性 : 
restaurant name 和 cuisine type。 创 建 一 个 名 为 describe restaurant() 的 方法 和 一 个 
名 为 open restaurant() 的 方法 ， 其 中 前 者 打印 前 述 两 项 信息 ， 而 后 者 打印 一 条 消息 ， 
指出 餐馆 正在 营业 。 
根据 这 个 类 创建 一 个 名 为 restaurant 的 实例 ， 分 别 打印 其 两 个 属性 ， 再 调用 前 述 
两 个 方法 。 


9-2 三 家 餐馆 : 根据 你 为 完成 练习 9-1 而 编写 的 类 创建 三 个 实例 ， 并 对 每 个 实例 调 
用 方法 describe restaurant()。 
9-3 us 创建 一 个 名 为 User 的 类 ,其 中 包含 属性 first name 和 1ast name,， 还 有 
用 户 简介 通常 会 存储 的 其 他 几 个 属性 。 在 类 User 中 定义 一 个 名 为 describe user() 的 方 
法 ， 0 再 定义 一 个 名 为 greet user() 的 方法 ， 它 向 用 户 发 出 个 性 化 
的 问候 。 
创建 多 个 表示 不 同 用 户 的 实例 ， 并 对 每 个 实例 都 调用 上 述 两 个 方法 。 


9.2 ”使 用 类 和 实例 
你 可 以 使 用 类 来 模拟 现实 世界 中 的 很 多 情景 。 类 编写 好 后 ,你 的 大 部 分 时 间 都 将 花 在 使 用 根 
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据 类 创建 的 实例 上 。 你 需要 执行 的 一 个 重要 任务 是 修改 实例 的 属性 。 你 可 以 直接 修改 实例 的 属性 ， 
也 可 以 编写 方法 以 特定 的 方式 进行 修改 。 


9.2.1 Car 类 
下 面 来 编写 一 个 表示 汽车 的 类 ， 它 存储 了 有 关 汽 车 的 信息 ， 还 有 一 个 汇总 这 些 信息 的 方法 : 
car.py 


class Car(): 
""" 一 次 模拟 汽车 的 简单 尝试 """ 


© def _init (self, make, model, year): 
"" "初始化 描述 汽车 的 属性 """ 
self.make = make 
self.model = model 
self.year = year 


© def get descriptive name(self): 
"0" 授 回 整 洁 的 描述 性 信息 "" 
long name = str(self.year) + ' ' + self.make + ' ' + self.model 
return long name.title() 


@ my new car = Car('audi', 'a4', 2016) 
print(my new car.get descriptive name()) 


在 @ 处 , 我 们 定义 了 方法 _init_()。 与 前 面 的 Dog 类 中 一 样 , 这 个 方法 的 第 一 个 形 参 为 self; 
我 们 还 在 这 个 方法 中 包含 了 另外 三 个 形 参 : make、model 和 year。 方法 _init () 接 受 这 些 形 参 的 
值 ， 并 将 它们 存储 在 根据 这 个 类 创建 的 实例 的 属性 中 。 创 建新 的 Car 实 例 时 ， 我 们 需要 指定 其 制 
造 商 、 型 号 和 生产 年 份 。 

在 @ 处 , 我 们 定义 了 一 个 名 为 get_descriptive_name() 的 方法 , 它 使 用 属性 year、make 和 model 
创建 一 个 对 汽车 进行 描述 的 字符 串 , 让 我 们 无 需 分 别 打 印 每 个 属性 的 值 。 为 在 这 个 方法 中 访问 属 
性 的 值 ， 我 们 使 用 了 self.make、self.model 和 self.year。 在 人 @ 处 ， 我 们 根据 Car 类 创建 了 一 个 实 
例 ， 并 将 其 存储 到 变量 my_new_car 中 。 接 下 来 ,我们 调用 方法 get_descriptive_name()， 指 出 我 
们 拥有 的 是 一 辆 什么 样 的 汽车 : 


2016 Audi A4 


为 让 这 个 类 更 有 趣 ， 下 面 给 它 添加 一 个 随时 间 变化 的 属性 ， 它 存储 汽车 的 总 里 程 。 
9.2.2 ”给 属性 指定 默认 值 


类 中 的 每 个 属性 都 必须 有 初始 值 ， 哪 怕 这 个 值 是 0 或 空 字符 串 。 在 有 些 情 况 下 ， 如 设置 默认 
值 时 ， 在 方法 _init_() 内 指定 这 种 初始 值 是 可 行 的 ; 如 果 你 对 某 个 属性 这 样 做 了 ， 就 无 需 包 含 
为 它 提供 初始 值 的 形 参 。 
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下 面 来 添加 一 个 名 为 odometer_reading 的 属性 ， 其 初始 值 总 是 为 0。 我 们 还 添加 了 一 个 名 为 


read_odometer() 的 方法 ， 用 于 读 取 汽车 的 里 程 表 : 


class Car(): 


def init (self, make, model, year): 
""" 初 始 化 描述 汽车 的 属性 """ 
self.make = make 
self.model = model 
self.year = year 
@ self.odometer reading = 0 


def get descriptive name(self): 
-- Snip-- 


@ def read odometer(self): 
""" 打 印 一 条 指出 汽车 里 程 的 消息 """ 


print("This car has ”+ str(self.odometer reading) + " 


my_new car = Car('audi', 'a4', 2016) 
print(my new car.get descriptive name()) 
my_new_car.read odometer() 


miles on it.") 


现在 ， 当 Python 调 用 方法 _init _() 来 创建 新 实例 时 ， 将 像 前 一 个 示例 一 样 以 属性 的 方式 存 
储 制 造 商 、 型 号 和 生产 年 份 。 接 下 来 ，Python 将 创建 一 个 名 为 odometer reading 的 属性 ， 并 将 其 
初始 值 设置 为 0 ( 见 @ )。 在 @ 处 ,我们 还 定义 了 一 个 名 为 read_odometer() 的 方法 ， 它 让 你 能 够 轻 


松 地 获悉 汽车 的 里 程 。 
一 开始 汽车 的 里 程 为 0: 


2016 Audi A4 
This car has 0 miles on it. 


出 售 时 里 程 表 读 数 为 0 的 汽车 并 不 多 ， 因 此 我 们 需要 一 个 修改 该 属性 的 值 的 途径 。 


9.2.3 ”修改 属性 的 值 

可 以 以 三 种 不 同 的 方式 修改 属性 的 值 : 直接 通过 实例 进 
法 进行 递增 ( 增加 特定 的 值 )。 下 面 依次 介绍 这 些 方法 。 

1. 直接 修改 属性 的 值 


人 


位 


修改 ; 通过 方法 进行 设置 ; 通过 方 


要 修改 属性 的 值 , 最 简单 的 方式 是 通过 实例 直接 访问 它 。 下 面 的 代码 直接 将 里 程 表 读 数 设置 


为 23 : 


class Car(): 


-- Snip-- 


my_new car = Car('audi', 'a4', 2016) 
print(my new car.get descriptive name()) 
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@ my new car.odometer reading = 23 
my_new car.read odometer() 


在 @ 处 ， 我 们 使 用 句点 表示 法 来 直接 访问 并 设置 汽车 的 属性 odometer_reading。 这 行 代码 让 
Python 在 实例 my_new_car 中 找到 属性 odometer reading， 并 将 该 属性 的 值 设置 为 23: 


2016 Audi A4 

This car has 23 miles on it. 

有 时 候 需 要 像 这 样 直 接 访问 属性 ， 但 其 他 时 候 需要 编写 对 

2. 通过 方法 修改 属性 的 值 

如 果 有 蔡 你 更 新 属性 的 方法 ,将 大 有 神 益 。 这 样 ， 你 就 无 需 直 接 访 问 属性 ， 而 可 将 值 传递 给 
一 个 方法 ， 由 它 在 内 部 进行 更 新 。 

下 面 的 示例 演示 了 一 个 名 为 update_odometer() 的 方法 : 


l 


遇 性 进行 更 新 的 方法 。 


三 
orl 


Er 


class Car(): 
-- SNip-- 


@ def update odometer(self, mileage): 9 


""" 将 里 程 表 读数 设置 为 指定 的 值 "'"" 
self.odometer reading = mileage 


my new car = Car('audi', 'a4', 2016) 
print(my new car.get descriptive name()) 


@ my new car.update odometer(23) 
my_new car.read odometer() 


对 Car 类 所 做 的 唯一 修改 是 在 @ 处 添加 了 方法 update_odometer()。 这 个 方法 接受 一 个 里 程 值 ， 
并 将 其 存储 到 self.odometer_reading 中 。 在 @ 处 , 我 们 调用 了 update_odometer()， 并 向 它 提供 了 
实 参 23( 该 实 参 对 应 于 方法 定义 中 的 形 参 mileage )。 它 将 里 程 表 读数 设置 为 23 ; 而 方法 
read_odometer() 打 印 该 读数 : 


2016 Audi A4 
This car has 23 miles on it. 


可 对 方法 update_odometer() 进 行 扩展 , 使 其 在 修改 里 程 表 读数 时 做 些 额 外 的 工作 。 下 面 来 添 
加 一 些 逻 辑 ， 禁 止 任何 人 将 里 程 表 读 数 往 回 调 : 


class Car(): 
-- Snip-- 


def update odometer(self, mileage): 


将 里 程 表 读 数 设置 为 指定 的 值 
禁止 将 里 程 表 读 数 往 回 调 
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@ if mileage >= self.odometer reading: 
self.odometer reading = mileage 
else: 
29 print("You can't roll back an odometer!") 


现在 ，update_odometer() 在 修改 属性 前 检查 指定 的 读数 是 否 合理 。 如 果 新 指定 的 里 程 
(mileage ) 大 于 或 等 于 原来 的 里 程 ( self.odometer reading )， 就 将 里 程 表 读数 改 为 新 指定 的 里 
程 ( 见 @ ); 否则 就 发 出 警告 ,指出 不 能 将 里 程 表 往 回 拨 ( 见 @ )。 

3. 通过 方法 对 属性 的 值 进 行 递增 

有 时 候 需 要 将 属性 值 递增 特定 的 量 , 而 不 是 将 其 设置 为 全 新 的 值 。 假设 我 们 购买 了 一 辆 二 手 
车 ， 且 从 购买 到 登记 期 间 增加 了 100 英 里 的 里 程 ， 下 面 的 方法 让 我 们 能 够 传递 这 个 增 量 ， 并 相应 
地 增加 里 程 表 读数 : 


class Car(): 
-- SNnip-- 


def update odometer(self, mileage): 
-- SNnip-- 


© def increment odometer(self, miles): 
mi" 将 里 程 表 读数 增加 指定 的 量 """ 
self.odometer reading += miles 


@ my used car = Car('subaru', 'outback', 2013) 
print(my_used car.get descriptive name()) 


四 my used car.update odometer(23500) 
my_used car.read odometer() 


@ my used car.increment odometer(100) 
my_used car.read odometer() 


在 @ 人 处 ， 新 增 的 方法 increment_odometer() 接 受 一 个 单位 为 英里 的 数字 ， 并 将 其 加 入 到 
self.odometer reading 中 。 在 @ 处 ,我 们 创建 了 一 辆 二 手 车 my_used_car。 在 人 @ 处 , 我 们 调用 
方法 update_odometer() 并 传人 23500, 将 这 辆 二 手 车 的 里 程 表 读数 设置 为 23 500。 在 @ 处 , 我们 调 
用 increment_odometer() 并 传人 100， 以 增加 从 购买 到 登记 期 间 行 驶 的 100 英 里 : 

2013 Subaru Outback 


This car has 23500 miles on it. 
This car has 23600 miles on it. 


你 可 以 轻松 地 修改 这 个 方法 ， 以 禁止 增 量 为 负 值 ， 从 而 防止 有 人 利用 它 来 回 拨 里 程 表 。 


注意 ”你 可 以 使 用 类 似 于 上 面 的 方法 来 控制 用 户 修 改 属性 值 ( 如 里 程 表 读 数 ) 的 方式 ， 但 能 
访问 程序 的 人 都 可 以 通过 直接 访问 属性 来 将 里 程 表 修改 为 任何 值 。 要 确保 安全 ， 除 了 进 
行 类 似 于 前 面 的 基本 检查 外 ， 还 需 特别 注意 细节 。 
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动手 试 一 斌 


9-4 就 餐 人 数 : 在 为 完成 练习 9-1 而 编写 的 程序 中 ， 添 加 一 个 名 为 number served 
的 属性 ， 并 将 其 默认 值 设置 为 0。 根据 这 个 类 创建 一 个 名 为 restaurant 的 实例 ; 打印 有 
多 少 人 在 这 家 餐馆 就 餐 过 ， 然 后 修改 这 个 值 并 再 次 打印 它 。 

添加 一 个 名 为 set_number served() 的 方法 ， 它 让 你 能 够 设置 就 餐 人 数 。 调 用 这 个 
方法 并 向 它 传递 一 个 值 ， 然 后 再 次 打印 这 个 值 。 

添加 一 个 名 为 increment number _ setved() 的 方法 ， 它 让 你 能 够 将 就 餐 人 数 递增 。 


调用 这 个 方法 并 向 它 传递 一 个 这 样 的 值 : 你 认为 这 家 餐馆 每 天 可 能 接待 的 就 餐 人 数 。 

9-5 尝试 登录 次 数 : 在 为 完成 练习 9-3 而 编写 的 User 类 中 ， 添 加 一 个 名 为 
login attempts 的 属性 。 编 写 一 个 名 为 increment login attempts() 的 方法 ， 它 将 属性 
login attempts 的 值 加 1。 再 编写 一 个 名 为 reset login attempts() 的 方法 ， 它 将 属性 
login attempts 的 值 重 置 为 0。 

根据 User 类 创建 一 个 实例 ,再 调用 方法 increment login attempts() 多 次 。 打印 属 
性 login attempts 的 值 , 确 认 它 被 正确 地 递增 ;然后 ,调用 方法 Teset login attempts()， 
并 再 次 打印 属性 login attempts 的 值 ， 确 认 它 被 重 置 为 0。 


9.3 继承 


编写 类 时 , 并非 总 是 要 从 空白 开始 。 如 果 你 要 编写 的 类 是 另 一 个 现成 类 的 特殊 版 本 ， 可 使 用 
继承 。 一 个 类 继承 另 一 个 类 时 ， 它 将 自动 获得 另 一 个 类 的 所 有 属性 和 方法 ; 原 有 的 类 称 为 父 类 ， 
而 新 类 称 为 子 类 。 子 类 继承 了 其 父 类 的 所 有 属性 和 方法 ， 同 时 还 可 以 定义 自己 的 属性 和 方法 。 


9.3.1 子 类 的 方法 init () 


创建 子 类 的 实例 时 ，Python 首 先 需 要 完成 的 任务 是 给 父 类 的 所 有 属性 赋值 。 为 此 ， 子 类 的 方 
法 _init () 需 要 父 类 施 以 援手 。 

例如 ， 下 面 来 模拟 电动 汽车 。 电 动 汽 车 是 一 种 特殊 的 汽车 ， 因 此 我 们 可 以 在 前 面 创建 的 Car 
类 的 基础 上 创建 新 类 Electriccar， 这 样 我 们 就 只 需 为 电动 汽车 特有 的 属性 和 行为 编写 代码 。 

下 面 来 创建 一 个 简单 的 ElectricCar 类 版 本 ， 它 具备 Car 类 的 所 有 功能 : 


electric_car.py 


1 


@ class Car(): 


mn 次 模拟 汽 车 的 简 单 党 1 nn 


def init (self, make, model, year): 
self.make = make 


self.model = model 


148 第 9 章 类 


self.year = year 
self.odometer reading = 0 


< 


ef get descriptive name(self) 
long name = str(self.year) + ' ' + self.make + ' ' + self.model 


return long name.title() 


i 


ef read odometer(self): 


print("This car has " + str(self.odometer reading) + " miles on it.") 


十 


ef update odometer(self, mileage): 

if mileage >= self.odometer reading: 
self.odometer reading = mileage 

else: 


print("You can't roll back an odometer!") 


def increment odometer(self, miles): 
self.odometer reading += miles 


@ class ElectricCar(Car): 
""" 电 动 汽车 的 独特 之 处 """ 


【3 def _init (self, make, model, year) 
"" "初始 化 父 类 的 属性 """ 
@ super(). init (make, model, year) 


© my tesla = ElectricCar('tesla', 'model s', 2016) 
print(my tesla.get descriptive name()) 


首先 是 Car 类 的 代码 ( 见 @ ),。 创建 子 类 时 ， 父 类 必须 包含 在 当前 文件 中 ， 且 位 于 子 类 前 面 。 
在 @ 处 ,我 们 定义 了 子 类 ElectricCcar。 定 义 子 类 时 ,必须 在 括号 内 指定 父 类 的 名 称 。 方 法 _init _() 
接受 创建 Car 实例 所 需 的 信息 ( 见 @ )。 

@ 处 的 super() 是 一 个 特殊 函数 ， 帮 助 Python 将 父 类 和 子 类 关联 起 来 。 这 行 代码 让 Python 调用 
ElectricCar 的 父 类 的 方法 _init_()， 让 ElectricCar 实 例 包 含 父 类 的 所 有 属性 。 父 类 也 称 为 超 
类 ( superclass )， 名 称 super 因 此 而 得 名 。 

为 测试 继承 是 否 能 够 正确 地 发 挥 作用 , 我 们 尝试 创建 一 辆 电动 汽车 , 但 提供 的 信息 与 创建 普 
通 汽 车 时 相同 。 在 @ 处 ,我 们 创建 ElectricCcar 类 的 一 个 实例 ， 并 将 其 存储 在 变量 my_tesla 中 。 这 
行 代码 调用 ElectricCar 类 中 定义 的 方法 _init _()， 后 者 让 Python 调用 父 类 Car 中 定义 的 方法 
_init ()。 我 们 提供 了 实 参 'tesla' 、'model s' 和 2016。 

除 方 法 _init () 外 ,电动 汽车 没有 其 他 特有 的 属性 和 方法 。 当 前 ,我们 只 想 确 认 电 动 汽车 
具备 普通 汽车 的 行为 : 


2016 Tesla Model S 


ElectricCar 实 例 的 行为 与 Car 实 例 一 样 ， 现 在 可 以 开始 定义 电动 汽车 特有 的 属性 和 方法 了 。 
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9.3.2 ”Python 2.7 中 的 继承 


在 Python 2.7 中 ， 继 承 语法 稍 有 不 同 ，ElectricCar 类 的 定义 类 似 于 下 面 这 样 : 
class Car(object): 


def init (self, make, model, year): 
--SNnip-- 
class ElectricCar(Car): 

def init (self, make, model, year): 


super(ElectricCar, self). init (make, model, year) 
-- SNip-- 


函数 super() 需 要 两 个 实 参 : 子 类 名 和 对 象 self。 为 帮助 Python 将 父 类 和 子 类 关联 起 来 , 这些 
实 参 必 不 可 少 。 另 外 ， 在 Python 2.7 中 使 用 继承 时 ， 务 必 在 定义 父 类 时 在 括号 内 指定 object。 


9.3.3 ”给 子 类 定义 属性 和 方法 


让 一 个 类 继承 男 一 个 类 后 ， 可 添加 区 分 子 类 和 父 类 所 需 的 新 属性 和 方法 。 
下 面 来 添加 一 个 电动 汽车 特有 的 属性 ( 电瓶 )， 以 及 一 个 描述 该 属性 的 方法 。 我 们 将 存储 电 
瓶 容量 ， 并 编写 一 个 打印 电瓶 描述 的 方法 : 


class Car(): 


-- Ship-- 


class ElectricCar(Car): 
"""Represent aspects of a car, specific to electric vehicles. 
def init (self, make, model, year): 
电动 汽车 的 独特 之 处 
初始 化 父 类 的 属性 ， 再 初始 化 电动 汽车 特有 的 属性 
super(). init (ma 
© 


ke, model, year) 
self.battery size = 70 


@ def describe battery(se 


"" "打印 一 条 描述 电瓶 
print("This car has 


Fe 
容量 的 消息 "om 
a 


+ Str(self.battery size) + "-kWh battery.") 
my _ tesla = ElectricCar('tesla', "model s', 2016) 

print(my tesla.get descriptive name()) 
my_tesla.describe battery() 


在 @ 处 , 我 们 添加 了 新 属性 self.battery_size, 并 设置 其 初始 值 ( 如 70 )。 根据 ElectricCar 类 
创建 的 所 有 实例 都 将 包含 这 个 


属性 ， 但 所 有 Car 实 例 都 不 包含 它 。 在 @ 处 ， 我 们 还 添加 了 一 个 名 
为 describe_battery() 的 方法 ， 它 打印 有 关 电 瓶 的 信息 。 我 们 调用 这 个 方法 时 ， 将 看 到 一 条 电动 
汽车 特有 的 描述 : 
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2016 Tesla Model S 
This car has a 70-kWh battery. 


对 于 ElectricCar 类 的 特殊 化 程度 没有 任何 限制 。 模 拟 电动 汽车 时 ， 你 可 以 根据 所 需 的 准确 
程度 添加 任意 数量 的 属性 和 方法 。 如 果 一 个 属性 或 方法 是 任何 汽车 都 有 的 , 而 不 是 电动 汽车 特有 
的 ， 就 应 将 其 加 入 到 car 类 而 不 是 ElectricCar 类 中 。 这样 ,使 用 Car 类 的 人 将 获得 相应 的 功能 ， 
ElectricCar 类 只 包含 处 理 电 动 汽车 特有 属性 和 行为 的 代码 。 


9.3.4 ” 重 写 父 类 的 方法 


对 于 父 类 的 方法 ， 只 要 它 不 符合 子 类 模拟 的 实物 的 行为 ,都 可 对 其 进行 重 写 。 为 此 ， 可 在 子 
类 中 定义 一 个 这 样 的 方法 ， 即 它 与 要 重 写 的 父 类 方法 同名 。 这 样 ，Python 将 不 会 考虑 这 个 父 类 方 
法 ， 而 只 关注 你 在 子 类 中 定义 的 相应 方法 。 

假设 Car 类 有 一 个 名 为 fill _ gas _tank() 的 方法 ， 它 对 全 电动 汽车 来 说 毫 无 意义 ， 因 此 你 可 能 
想 重 写 它 。 下 面 演示 了 一 种 重 写 方式 : 

def ElectricCar(Car): 


--5/17]7-- 


def fill gas tank(): 
"mm 电动 汽车 没有 油箱 """ 
print("This car doesn't need a gas tank!") 


现在 ， 如 果 有 人 对 电动 汽车 调用 方法 fill gas tank() ，Python 将 忽略 Car 类 中 的 方法 
fill gas_tank()， 转 而 运行 上 述 代码 。 使 用 继承 时 ， 可 让 子 类 保留 从 父 类 那里 继承 而 来 的 精华 ， 
并 剔除 不 需要 的 糟粕 。 


9.3.5 ”将 实例 用 作 属 性 


使 用 代码 模拟 实物 时 , 你 可 能 会 发 现 自己 给 类 添加 的 细节 越 来 越 多 : 属性 和 方法 清单 以 及 文 
件 都 越 来 越 长 。 在 这 种 情况 下 ， 可 能 需要 将 类 的 一 部 分 作为 一 个 独立 的 类 提取 出 来 。 你 可 以 将 大 
型 类 拆 分 成 多 个 协同 工作 的 小 类 。 

例如 ， 不 断 给 Electriccar 类 添加 细节 时 ， 我 们 可 能 会 发 现 其 中 包含 很 多 专门 针对 汽车 电瓶 
的 属性 和 方法 。 在 这 种 情况 下 ， 我 们 可 将 这 些 属性 和 方法 提取 出 来 ， 放 到 另 一 个 名 为 Battery 的 
类 中 ， 并 将 一 个 Battery 实 例 用 作 ElectricCar 类 的 一 个 属性 : 


class Car(): 
-- Snip-- 


@ class Battery(): 
""" 一 次 模拟 电动 汽车 电 注 的 简单 尝试 """ 


@ def _init (self, battery size=70): 
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mm 初始 化 电文 的 属性 """ 
self.battery size = battery size 


(3 def describe battery(self): 


"打印 二 条 描述 电 参 容量 的 消息 "" 
print("This car has a " + str(self.battery size) + "-kWh battery.") 


class ElectricCar(Car): 
"" "电动 汽 车 的 独特 之 处 """ 
def init (self, make, model, year): 
初始 化 父 类 的 属性 ， 再 初始 化 电动 汽车 特有 的 属性 
super(). init (make, model, year) 
9 self.battery = Battery() 
my_tesla = ElectricCar('tesla', 'model s', 2016) 


print(my tesla.get descriptive name()) 
my_tesla.battery.describe battery() 


在 @ 处 ,我 们 定义 了 一 个 名 为 Battery 的 新 类 ， 它 没有 继承 任何 类 。@ 处 的 方法 _init () 除 
self 外 ， 还 有 另 一 个 形 参 battery_size。 这 个 形 参 是 可 选 的 : 如 果 没 有 给 它 提 供 值 ， 电 瓶 容量 将 
被 设置 为 70。 方 法 describe battery() 也 移 到 了 这 个 类 中 ( 见 @ )。 

在 ElectricCar 类 中 ， 我 们 添加 了 一 个 名 为 self.battery 的 属性 ( 见 @ )。 这 行 代 码 让 Python 
创建 一 个 新 的 Battery 实 例 ( 由 于 没有 指定 尺寸 ， 因 此 为 默认 值 70 )， 并 将 该 实例 存储 在 属性 
self.battery 中 。 每 当 方 法 _init () 被 调用 时 ， 都 将 执行 该 操作 ; 因此 现在 每 个 ElectricCar 实 
例 都 包含 一 个 自动 创建 的 Battery 实 例 。 

我 们 创建 一 辆 电动 汽车 ， 并 将 其 存储 在 变量 my tes1a 中 。 要 描述 电瓶 时 ， 需 要 使 用 电动 汽车 
的 属性 battery: 


i 


my_tesla.battery.describe battery() 


这 行 代 码 让 Python 在 实例 my_tesla 中 查找 属性 battery， 并 对 存储 在 该 属性 中 的 Battery 实 例 
调用 方法 describe battery()。 
输出 与 我 们 前 面 看 到 的 相同 : 


2016 Tesla Model S 
This car has a 70-kWh battery. 


这 看 似 做 了 很 多 额外 的 工作 , 但 现在 我 们 想 多 详细 地 描述 电瓶 都 可 以 , 且 不 会 导致 ElectricCar 
类 混乱 不 堪 。 下 面 再 给 Battery 类 添加 一 个 方法 ， 它 根据 电 族 容 量 报告 汽车 的 续航 里 程 : 
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class Car(): 


-- Ship-- 


class Battery(): 


有 - SN1p- 已 


© def get range(self): 
""" 打 印 一 条 消息 ， 指 出 电 痊 的 续航 里 程 """ 
if self.battery size == 70: 


range = 240 
elif self.battery size == 85: 
range = 270 


message = "This car can go approximately " + str(range) 
message += " miles on a full charge." 
print(message) 


class ElectricCar(Car): 
-- Snip-- 


my_tesla = ElectricCar('tesla', 'model s', 2016) 
print(my tesla.get descriptive name()) 
my_tesla.battery.describe battery() 

@ my tesla.battery.get range() 


@ 处 新 增 的 方法 get_range() 做 了 一 些 简单 的 分 析 : 如 果 电 瓶 的 容量 为 70kWh, 它 就 将 续航 里 
程 设置 为 240 英 里 ; 如 果 容 量 为 85kWh， 就 将 续航 里 程 设置 为 270 英 里 ,然后 报告 这 个 值 。 为 使 用 


这 个 方法 ,我们 也 通过 汽车 的 属性 battery 来 调用 它 ( 见 @ )。 
输出 指出 了 汽车 的 续航 里 程 (这 取决 于 电瓶 的 容量 ): 


2016 Tesla Model S 
This car has a 70-kWh battery. 
This car can go approximately 240 miles on a full charge. 


9.3.6 ”模拟 实物 


模拟 较 复 杂 的 物件 ( 如 电动 汽车 ) 时 ， 需 要 解决 一 些 有 趣 的 问题 。 续 航 里 程 是 电瓶 的 属性 还 


是 汽车 的 属性 呢 ? 如 果 我 们 只 需 描述 一 辆 汽车 , 那么 将 方法 get_range() 放 在 Bati 
适 的 ; 但 如 果 要 描述 一 家 汽车 制造 商 的 整个 产品 线 , 也 许 应 该 将 方法 get_range( 


tery 类 中 也 许 是 合 
) 移 到 ElectricCar 


类 中 。 在 这 种 情况 下 ，get_range() 依 然 根据 电瓶 容量 来 确定 续航 里 程 ， 但 报告 的 是 一 款 汽车 的 续 
航 里 程 。 我 们 也 可 以 这 样 做 : 将 方法 get_range() 还 留 在 Battery 类 中 ,但 向 它 传递 一 个 参数 ， 如 


航 里 程 。 


car_model; 在 这 种 情况 下 ， 方法 get_range() 将 根据 电瓶 容量 和 汽车 型 号 报告 续 


这 让 你 进入 了 程序 员 的 男 一 个 境界 : 解决 上 述 问 题 时 , 你 从 较 高 的 逻辑 层面 ( 而 不 是 语法 层 
面 ) 考虑 ; 你 考虑 的 不 是 Python ， 而 是 如 何 使 用 代码 来 表示 实物 。 到 达 这 种 境界 后 ， 你 经 常会 发 
现 ， 现 实 世界 的 建 模 方法 并 没有 对 错 之 分 。 有 些 方法 的 效率 更 高 ， 但 要 找 出 效率 最 高 的 表示 法 ， 
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需要 经 过 一 定 的 实践 。 只 要 代码 像 你 希望 的 那样 运行 ， 就 说 明 你 做 得 很 好 ! 即便 你 发 现 自己 不 得 
不 多 次 尝试 使 用 不 同 的 方法 来 重 写 类 ,也 不 必 气 蚀 ; 要 编写 出 高 效 、 准 确 的 代码 ， 都 得 经 过 这 样 
的 过 程 。 


动手 试 一 试 

9-6 冰淇淋 小 店 : 冰 洪 淋 小 店 是 一 种 特殊 的 餐馆 。 编 写 一 个 名 为 IceCreamStand 的 
类 ， 让 它 继承 你 为 完成 练习 9-1 或 练习 9-4 而 编写 的 Restaurant 类 。 这 两 个 版 本 的 
Restaurant 类 都 可 以 ， 挑 选 你 更 喜欢 的 那个 即 可 。 添加 一 个 名 为 flavors 的 属性 ， 用 于 
存储 一 个 由 各 种 口味 的 冰淇淋 组 成 的 列表 。 编写 一 个 显示 这 些 冰淇淋 的 方法 。 创建 一 个 
IceCreamStand 实例 ， 并 调用 这 个 方法 。 

9-7 管理 员 : 管理 员 是 一 种 特殊 的 用 户 。 编 写 一 个 名 为 Admin 的 类 ， 让 它 继承 你 为 
完成 练习 9-3 或 练习 9-5 而 编写 的 User 类 。 添 加 一 个 名 为 privileges 的 属性 ， 用 于 存 
储 一 个 由 字符 事 ( 如 "can add post"、"can delete post"、"can ban user" 等 ) 组 成 的 
列表 。 编 写 一 个 名 为 show_privileges() 的 方法 ， 它 显示 管理 员 的 权限 。 创建 一 个 Admin 
实例 ， 并 调用 这 个 方法 。 

9-8 权限 : 编写 一 个 名 为 Privileges 的 类 ， 它 只 有 一 个 属性 privileges， 其 中 
存储 了 练习 9-7 所 说 的 字符 串 列 表 。 将 方法 show privileges() 移 到 这 个 类 中 。 在 Admin 
类 中 ， 将 一 个 Privileges 实例 用 作 其 属性 。 创 建 一 个 Admin 实例 ， 并 使 用 方法 
show privileges() 来 显示 其 权限 。 

9-9 电瓶 升级 : 在 本 节 最 后 一 个 electric car.py 版 本 中 ,给 Battery 类 添加 一 个 名 为 
upgrade battery() 的 方法 。 这 个 方法 检查 电瓶 容量 ， 如 果 它 不 是 85， 就 将 它 设置 为 85。 
创建 一 辆 电瓶 容量 为 默认 值 的 电动 汽车 ,调用 方法 get_ Tange()， 然 后 对 电瓶 进行 升级 ， 
并 再 次 调用 get range()。 你 会 看 到 这 辆 汽车 的 续航 里 程 增 加 了 。 


9.4 导入 类 


随 着 你 不 断 地 给 类 添加 功能 , 文件 可 能 变 得 很 长 ， 即 便 你 妥善 地 使 用 了 继承 亦 如 此 。 为 遵循 
Python 的 总 体 理念 ， 应 让 文件 尽 可 能 整洁 。 为 在 这 方面 提供 帮助 ，Python 人 允许 你 将 类 存储 在 模块 
中 ， 然 后 在 主 程序 中 导入 所 需 的 模块 。 


9.4.1 导入 单个 类 


下 面 来 创建 一 个 只 包含 Car 类 的 模块 。 这 让 我 们 面临 一 个 微妙 的 命名 问题 : 在 本 章 中 ， 已 经 
有 一 个 名 为 carpy 的 文件 ,但 这 个 模块 也 应 命名 为 carpy， 因 为 它 包含 表示 汽车 的 代码 。 我 们 将 这 
样 解 决 这 个 命名 问题 : 将 Car 类 存储 在 一 个 名 为 carpy 的 模块 中 ， 该 模块 将 覆盖 前 面 使 用 的 文件 
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carpy。 从 现在 开始 ， 使 用 该 模块 的 程序 都 必须 使 用 更 具体 的 文件 名 ， 如 my_carpy。 下 面 是 模块 
car.py， 其 中 只 包含 car 类 的 代码 : 


car.py 
@""" 一 个 可 用 于 表示 汽车 的 类 """ 


class Car(): 
""" 一 次 模拟 汽车 的 简单 尝试 """ 


def init (self, make, model, year): 
"" "初始 化 描述 汽车 的 属性 """ 
self.make = make 
self.model = model 
self.year = year 
self.odometer reading = 0 


def get descriptive name(self): 

"" "返回 整洁 的 描述 性 名 称 """ 

long name = str(self.year) + ' ' + self.make + ' ' + self.model 
return long name.title() 


def read odometer(self): 
"" "打印 一 条 消息 ， 指 出 汽车 的 里 程 """ 
print("This car has " + str(self.odometer reading) + " miles on it.") 


def update odometer(self, mileage): 


将 里 程 表 读数 设置 为 指定 的 值 
拒绝 将 里 程 表 往 回 拨 


if mileage >= self.odometer Teading: 
self.odometer reading = mileage 

else: 
print("You can't roll back an odometer!") 


def increment odometer(self, miles): 
""" 将 里 程 表 读数 增加 指定 的 量 """ 
self.odometer reading += miles 


在 @ 处 ,我 们 包含 了 一 个 模块 级 文档 字符 串 ， 对 该 模块 的 内 容 做 了 简要 的 描述 。 你 应 为 自己 
创建 的 每 个 模块 都 编写 文档 字符 串 。 
下 面 来 创建 男 一 个 文件 一 my_car.py， 在 其 中 导入 Car 类 并 创建 其 实例 : 


my_car.py 


@ from car import Car 


my_new car = Car('audi', 'a4', 2016) 
print(my new car.get descriptive name()) 


my_new car.odometer reading = 23 
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my_new car.read odometer() 


@ 处 的 import 语 句 让 Python 打开 模块 car, 并 导入 其 中 的 car 类 。 这 样 我 们 就 可 以 使 用 car 类 了 ， 
就 像 它 是 在 这 个 文件 中 定义 的 一 样 。 输 出 与 我 们 在 前 面 看 到 的 一 样 : 


2016 Audi A4 
This car has 23 miles on it. 


导入 类 是 一 种 有 效 的 编程 方式 。 如 果 在 这 个 程序 中 包含 了 整个 Car 类 ， 它 该 有 多 长 呀 ! 通过 
将 这 个 类 移 到 一 个 模块 中 , 并 导入 该 模块 ,你 依然 可 以 使 用 其 所 有 功能 , 但 主 程序 文件 变 得 整洁 
而 易于 阅读 了 。 这 还 能 让 你 将 大 部 分 逻辑 存储 在 独立 的 文件 中 ; 确定 类 像 你 希望 的 那样 工作 后 ， 
你 就 可 以 不 管 这 些 文件 ， 而 专注 于 主 程序 的 高 级 逻辑 了 。 


9.4.2 在 一 个 模块 中 存储 多 个 类 


虽然 同一 个 模块 中 的 类 之 间 应 存在 某 种 相关 性 , 但 可 根据 需要 在 一 个 模块 中 存储 任意 数量 的 
类 。 类 Battery 和 ElectricCar 都 可 帮助 模拟 汽车 ， 因 此 下 面 将 它们 都 加 入 模块 carpy 中 : 


car.py 
"" 一 组 用 于 表示 燃油 汽车 和 电动 汽车 的 类 """ 


class Car(): 
-- Snip-- 


class Battery(): 
" "一 次 模拟 电动 汽车 电 洽 的 简单 尝试 " 


def init (self, battery size=60): 
"" "初始化 电 痊 的 属性 """ 
self.battery size = battery size 


de 


be 


describe battery(self): 
"" 打 印 一 条 描述 电 竹 容量 的 消息 """ 
print("This car has a " + str(self.battery size) + "-kWh battery.") 


de 


他 


get range(self): 
"" 打 印 一 条 描述 电 竹 续航 里 程 的 消息 """ 
if self.battery size == 70: 
range = 240 
elif self.battery size == 85: 


range = 270 
message = "This car can go approximately " + str(range) 
message += " miles on a full charge." 


print(message) 


class ElectricCar(Car): 
1 "模拟 电 动 汽车 的 独特 之 处 " 1 


super(). init (make, model, year) 
self.battery = Battery() 


现在 ,可 以 新 建 一 个 名 为 my_electric_car.py 的 文件 ， 导 入 ElectricCar 类 ， 并 创建 一 辆 电动 汽 
车 了 : 


my_electric_car.py 


from car import ElectricCar 
my_tesla = ElectricCar('tesla', 'model s', 2016) 
print(my tesla.get descriptive name()) 


my_tesla.battery.describe battery() 
my_tesla.battery.get range() 


输出 与 我 们 前 面 看 到 的 相同 ， 但 大 部 分 逻辑 都 隐藏 在 一 个 模块 中 : 


2016 Tesla Model S 
This car has a 70-kWh battery. 
This car can go approximately 240 miles on a full charge. 


9.4.3 ”从 一 个 模块 中 导入 多 个 类 


可 根据 需要 在 程序 文件 中 导入 任意 数量 的 类 。 如 果 我 们 要 在 同一 个 程序 中 创建 普通 汽车 和 电 
动 汽车 ， 就 需要 将 Car 和 ElectricCar 类 都 导入 : 


my_cars.py 


@ from car import Car, ElectricCar 


@ my beetle = Car('volkswagen', 'beetle', 2016) 
print(my_beetle.get descriptive name()) 


@ my tesla = ElectricCar('tesla', 'roadster', 2016) 
print(my tesla.get descriptive name()) 


在 @ 处 从 一 个 模块 中 导入 多 个 类 时 ， 用 肥 号 分 隔 了 各 个 类 。 导 入 必要 的 类 后 ,就 可 根据 需要 
创建 每 个 类 的 任意 数量 的 实例 。 

在 这 个 示例 中 ， 我 们 在 @ 处 创建 了 一 辆 大 众 甲 壳 虫 普通 汽车 ， 并 在 人 @ 处 创建 了 一 辆 特 斯 拉 
Roadster 电 动 汽 车 : 


2016 Volkswagen Beetle 
2016 Tesla Roadster 
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9.4.4 导入 整个 模块 


你 还 可 以 导入 整个 模块 ,再 使 用 句点 表示 法 访问 需要 的 类 。 这 种 导入 方法 很 简单 ,代码 也 易 
于 阅读 。 由 于 创建 类 实例 的 代码 都 包含 模块 名 ， 因 此 不 会 与 当前 文件 使 用 的 任何 名 称 发 生 冲 突 。 
下 面 的 代码 导入 整个 car 模 块 ， 并 创建 一 辆 普通 汽车 和 一 辆 电动 汽车 : 


my_cars.py 


@ import car 


@ my beetle = car.Car('volkswagen', 'beetle', 2016) 
print(my beetle.get descriptive name()) 


@ my tesla = car.ElectricCar('tesla', 'roadster', 2016) 
print(my tesla.get descriptive name()) 


在 @ 处 ,我 们 导入 了 整个 car 模 块 。 接 下 来 ,我 们 使 用 语法 modwIe_name. class_name 访 问 需 要 
的 类 。 像 前 面 一 样 , 我 们 在 @ 处 创建 了 一 辆 大 众 甲壳 虫 汽车 , 并 在 @ 处 创建 了 一 辆 特 斯 拉 Roadster 
各 和 5 
9.4.5 ”导入 模块 中 的 所 有 类 

要 导入 模块 中 的 每 个 类 ， 可 使 用 下 面 的 语法 : 


from module name import * 


不 推荐 使 用 这 种 导入 方式 ， 其 原因 有 二 。 首 先 ， 如 果 只 要 看 一 下 文件 开头 的 jmport 语 句 ， 就 
能 清楚 地 知道 程序 使 用 了 哪些 类 , 将 大 有 神 益 ; 但 这 种 导入 方式 没有 明确 地 指出 你 使 用 了 模块 中 
的 哪些 类 。 这 种 导入 方式 还 可 能 引发 名 称 方面 的 困惑 。 如 果 你 不 小 心 导 入 了 一 个 与 程序 文件 中 其 
他 东西 同名 的 类 , 将 引发 难以 诊断 的 错误 。 这 里 之 所 以 介绍 这 种 导入 方式 , 是 因为 虽然 不 推荐 使 
用 这 种 方式 ， 但 你 可 能 会 在 别人 编写 的 代码 中 见 到 它 。 

需要 从 一 个 模块 中 导入 很 多 类 时 ， 最 好 导 和 人 整个 模块 ， 并 使 用 modw7e_mname. class_name 语 法 
来 访问 类 。 这 样 做 时 ， 虽 然 文 件 开 头 并 没有 列 出 用 到 的 所 有 类 , 但 你 清楚 地 知道 在 程序 的 哪些 地 
方 使 用 了 导入 的 模块 ; 你 还 避免 了 导入 模块 中 的 每 个 类 可 能 引发 的 名 称 冲 突 。 


9.4.6 在 一 个 模块 中 导入 另 一 个 模块 


有 时 候 ， 需 要 将 类 分 散 到 多 个 模块 中 ， 以 免 模 块 太 大 ， 或 在 同一 个 模块 中 存储 不 相关 的 类 。 
将 类 存储 在 多 个 模块 中 时 , 你 可 能 会 发 现 一 个 模块 中 的 类 依赖 于 另 一 个 模块 中 的 类 。 在 这 种 情况 
下 ， 可 在 前 一 个 模块 中 导入 必要 的 类 。 

例如 ， 下 面 将 Caz 类 存储 在 一 个 模块 中 ， 并 将 ElectricCar 和 Battery 类 存储 在 另 一 个 模块 中 。 
我 们 将 第 二 个 模块 命名 为 electric_ car.py (这 将 覆盖 前 面 创建 的 文件 electric_carpy )， 并 将 
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闫 


Battery 和 ElectricCar 类 复制 到 这 个 模块 中 : 
electric_car.py 


"一 组 可 用 于 表示 电动 汽车 的 类 "0 
@ from car import Car 


class Battery(): 
-- Snip-- 


class ElectricCar(Car): 


2/ 


ElectricCar 类 需要 访问 其 父 类 Car， 因 此 在 @ 处 ,我 们 直接 将 Car 类 导入 该 模块 中 。 如 果 我 们 
忘记 了 这 行 代 码 ，Python 将 在 我 们 试图 创建 ElectricCar 实 例 时 引发 错误 。 我 们 还 需要 更 新 模块 
car， 使 其 包含 Car 类. 


car.py 
"" 一 个 可 用 于 表示 汽车 的 类 """ 


class Car(): 


snipD-- 
nip 


现在 可 以 分 别 从 每 个 模块 中 导入 类 ， 以 根据 需要 创建 任何 类 型 的 汽车 了 : 
my_cars.py 


@ from car import Car 
from electric car import ElectricCar 


my_beetle = Car('volkswagen', 'beetle', 2016) 
print(my_beetle.get descriptive name()) 


my_tesla = ElectricCar('tesla', 'roadster', 2016) 
print(my tesla.get descriptive name()) 


在 @ 人 处 ,我们 从 模块 car 中 导入 了 Car 类 ， 并 从 模块 electric car 中 导 和 ElectricCar 类 。 接 下 
来 ,我 们 创建 了 一 辆 普通 汽车 和 一 辆 电动 汽车 。 这 两 种 汽车 都 得 以 正确 地 创建 : 


2016 Volkswagen Beetle 
2016 Tesla Roadster 


9.4.7” 自 定义 工作 流程 


正如 你 看 到 的 ,在 组 织 大 型 项 目的 代码 方面 ,Python 提供 了 很 多 选项 。 熟 悉 所 有 这 些 选 项 很 
重要 ， 这 样 你 才能 确定 哪 种 项 目 组 织 方式 是 最 佳 的 ， 并 能 理解 别人 开发 的 项 目 。 
一 开始 应 让 代码 结构 尽 可 能 简单 。 先 尽 可 能 在 一 个 文件 中 完成 所 有 的 工作 , 确定 一 切 都 能 正 
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确 运 行 后 ， 再 将 类 移 到 独立 的 模块 中 。 如 果 你 喜欢 模块 和 文件 的 交互 方式 ,可 在 项 目 开始 时 就 尝 
试 将 类 存储 到 模块 中 。 先 找 出 让 你 能 够 编写 出 可 行 代码 的 方式 ， 表 尝试 让 代码 更 为 组 织 有 序 。 


动手 试 一 斌 


9-10 导入 Restaurant 类 : 将 最 新 的 Restaurant 类 存储 在 一 个 模块 中 。 在 另 一 个 文 
件 中 ,导入 Restaurant 类 ,创建 一 个 Restaurant 实例 , 并 调用 Restaurant 的 一 个 方法 ， 
以 确认 import 语句 正确 无 误 。 

9-11 导入 Admin 类 : 以 为 完成 练习 9-8 而 做 的 工作 为 基础 ， 将 User、Privileges 和 


Admin 类 存储 在 一 个 模块 中 ， 再 创建 一 个 文件 ， 在 其 中 创建 一 个 Admin 实例 并 对 其 调用 
方法 show privileges()， 以 确认 一 切 都 能 正确 地 运行 。 

9-12 多 个 模块 : 将 User 类 存储 在 一 个 模块 中 ， 并 将 Privileges 和 Admin 类 存储 在 
另 一 个 模块 中 。 再 创建 一 个 文件 ， 在 其 中 创建 一 个 Admin 实例 ， 并 对 其 调用 方法 
show privileges()， 以 确认 一 切 都 依然 能 够 正确 地 运行 。 


9.5 “Python 标准 库 


Python 标准 库 是 一 组 模块 , 安装 的 Python 都 包含 它 。 你 现在 对 类 的 工作 原理 已 有 大 致 的 了 解 ， 
可 以 开始 使 用 其 他 程序 员 编写 好 的 模块 了 。 可 使 用 标准 库 中 的 任何 函数 和 类 , 为 此 只 需 在 程序 开 
头 包含 一 条 简单 的 import 语 句 。 下 面 来 看 模块 collections 中 的 一 个 类 OrderedDict。 

字典 让 你 能 够 将 信息 关联 起 来 ， 但 它们 不 记录 你 添加 键 - 值 对 的 顺序 。 要 创建 字典 并 记录 其 
中 的 键 - 值 对 的 添加 顺序 ， 可 使 用 模块 collections 中 的 OrderedDict 类 。0rderedDict 实 例 的 行为 
几乎 与 字典 相同 ， 区 别 只 在 于 记录 了 键 - 值 对 的 添加 顺序 。 

我 们 再 来 看 一 看 第 6 章 的 favorite languages.py 示 例 ， 但 这 次 将 记录 被 调查 者 参与 调查 的 
顺序 : 


favorite_languages.py 


@ from collections import OrderedDict 
@ favorite languages = OrderedDict() 


@ favorite languages['jen'] = 'python 
favorite languages['sarah'] = 'c' 
favorite languages['edward'] = 'ruby' 
favorite languages['phil'] = “python' 


@ for name, language in favorite languages.items(): 
print(name.title() + "'s favorite language is ”+ 
language.title() + ".") 
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我 们 首先 从 模块 collections 中 导入 了 0rderedDict 类 ( 见 @ )。 在 @ 处 ,我 们 创建 了 orderedDict 
类 的 一 个 实例 ， 并 将 其 存储 到 favorite_languages 中 。 请 注意 ， 这 里 没有 使 用 花 括号 ， 而 是 调用 
OrderedDict() 来 创建 一 个 空 的 有 序 字 典 ， 并 将 其 存储 在 favorite_languages 中 。 接 下 来 ,我 们 以 
每 次 一 对 的 方式 添加 名 字 - 语 言 对 ( 见 @ )。 在 @ 处 ,我 们 遍历 favorite_languages， 但 知道 将 以 
添加 的 顺序 获取 调查 结果 : 


Jen's favorite language is Python. 
Sarah's favorite language is C. 

Edward's favorite language is Ruby. 
Phil's favorite language is Python. 


这 是 一 个 很 不 错 的 类 , 它 兼 具 列 表 和 字典 的 主要 优点 ( 在 将 信息 关联 起 来 的 同时 保留 原来 的 
顺序 )。 等 你 开始 对 关心 的 现实 情形 建 模 时 ， 可 能 会 发 现 有 序 字典 正好 能 够 满足 需求 。 随 着 你 对 
标准 库 的 了 解 越 来 越 深 入 ， 将 熟悉 大 量 可 帮助 你 处 理 常 见 情形 的 模块 。 


注意 ”你 还 可 以 从 其 他 地 方 下 载 外 部 模块 。 本 书 第 二 部 分 的 每 个 项 目 都 需要 使 用 外 部 模块 ， 届 
时 你 将 看 到 很 多 这 样 的 示例 。 


动手 试 一 试 

9-13 使 用 0rderedDict: 在 练习 6-4 中 ， 你 使 用 了 一 个 标准 字典 来 表示 词汇 表 。 请 
使 用 OrderedDict 类 来 重 写 这 个 程序 ， 并 确认 输出 的 顺序 与 你 在 字典 中 添加 键 - 值 对 的 
顺序 一 致 。 

9-14 山子 : 模块 random 包含 以 各 种 方式 生成 随机 数 的 函数 , 其 中 的 randint() 返 回 
一 个 位 于 指定 范围 内 的 整数 ， 例 如， 下 面 的 代码 返回 一 个 1~6 内 的 整数 : 


from random import randint 
x = randint(1, 6) 


请 创建 一 个 Die 类 ， 它 包含 一 个 名 为 sides 的 属性 ， 该 属性 的 默认 值 为 6。 编写 一 
个 名 为 roll die() 的 方法 ， 它 打印 位 于 1 和 山子 面 数 之 间 的 随机 数 。 创建 一 个 6 面 的 典 
子 ， 再 找 10 次 。 

创建 一 个 10 面 的 股子 和 一 个 20 面 的 贷 子 ， 并 将 它们 都 挪 10 次 。 

9-15 Python Module of the Week: 要 了 解 Python 标准 库 ， 一 个 很 不 错 的 资源 是 网 
站 Python Module ofthe Week。 请 访问 http://pymotw.com/ 并 查看 其 中 的 目录 , 在 其 中 找 
一 个 你 感 兴趣 的 模块 进行 探索 ， 或 阅读 模块 collections 和 random 的 文档 。 
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9.6 ”类 编码 风格 


你 必须 熟悉 有 些 与 类 相关 的 编码 风格 问题 ， 在 你 编写 的 程序 较 复 杂 时 尤其 如 此 。 

类 名 应 采用 驼峰 命名 法 ， 即 将 类 名 中 的 每 个 单词 的 首 字母 都 大 写 ， 而 不 使 用 下 划 线 。 实 例 名 
和 模块 名 都 采用 小 写 格式 ， 并 在 单词 之 间 加 上 下 划 线 。 

对 于 每 个 类 , 都 应 紧 跟 在 类 定义 后 面包 含 一 个 文档 字符 串 。 这 种 文档 字符 串 简要 地 描述 类 的 
功能 ， 并 遵循 编写 函数 的 文档 字符 串 时 采用 的 格式 约定 。 每 个 模块 也 都 应 包含 一 个 文档 字符 串 ， 
对 其 中 的 类 可 用 于 做 什么 进行 描述 。 

可 使 用 空 行 来 组 织 代码 ， 但 不 要 滥用 。 在 类 中 ， 可 使 用 一 个 空 行 来 分 隔 方 法 ; 而 在 模块 中 ， 
可 使 用 两 个 空 行 来 分 隔 类 。 

需要 同时 导入 标准 库 中 的 模块 和 你 编写 的 模块 时 ， 先 编写 导入 标准 库 模 块 的 import 语 句 ， 再 
添加 一 个 空 行 , 然后 编写 导入 你 自己 编写 的 模块 的 import 语 句 。 在 包含 多 条 import 语 句 的 程序 中 ， 
这 种 做 法 让 人 更 容易 明白 程序 使 用 的 各 个 模块 都 来 自 何方 。 
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在 本 章 中 ,你 学 习 了 : 如 何 编写 类 ; 如 何 使 用 属性 在 类 中 存储 信息 ， 以 及 如 何 编写 方法 ， 以 
让 类 具备 所 需 的 行为 ， 如 何 编写 方法 ”init ()， 以 便 根据 类 创建 包含 所 需 属 性 的 实例 。 你 见识 
了 如 何 修 改 实例 的 属性 一 一 包括 直接 修改 以 及 通过 方法 进行 修改 。 你 还 了 解 了 : 使 用 继承 可 简化 
相关 类 的 创建 工作 ; 将 一 个 类 的 实例 用 作 男 一 个 类 的 属性 可 让 类 更 简洁 。 

你 了 解 到 , 通过 将 类 存储 在 模块 中 , 并 在 需要 使 用 这 些 类 的 文件 中 导入 它们 ,可 让 项 目 组 织 
有 序 。 你 学 习 了 Python 标准 库 ， 并 见识 了 一 个 使 用 模块 collections 中 的 0rderedDict 类 的 示例 。 
最 后 ， 你 学 习 了 编写 类 时 应 遵循 的 Python 约定 。 

在 第 10 章 中 , 你 将 学 习 如 何 使 用 文件 , 这 让 你 能 够 保存 你 在 程序 中 所 做 的 工作 ,以 及 你 让 用 户 
做 的 工作 。 你 还 将 学 习 异 常 , 这 是 一 种 特殊 的 Python 类 , 用 于 帮助 你 在 发 生 错误 时 采取 相应 的 措施 。 


文件 和 异常 


至 此 ， 你 掌握 了 编写 组 织 有 序 而 易于 使 用 的 程序 所 需 的 基本 技 
能 ,该 考虑 让 程序 目标 更 明确 、 用 途 更 大 了 。 在 本 章 中 ,你 将 学 习 处 
理 文件 ， 让 程序 能 够 快速 地 分 析 大 量 的 数据 ; 你 将 学 习 错误 处 理 ， 避 
免 程序 在 面 对 意外 情形 时 前 溃 ; 你 将 学 习 异 常 ， 它 们 是 Python 创建 的 
特殊 对 象 ， 用 于 管理 程序 运行 时 出 现 的 错误 ; 你 还 将 学 习 模 块 json， 
它 让 你 能 够 保存 用 户 数据 ， 以 免 在 程序 停止 运行 后 丢失 。 

学 习 处 理 文件 和 保存 数据 可 让 你 的 程序 使 用 起 来 更 容易 : 用户 将 
能 够 选择 输入 什么 样 的 数据 ,以 及 在 什么 时 候 输 入 ; 用 户 使 用 你 的 程 
序 做 一 些 工作 后 ,可 将 程序 关闭 ,以 后 再 接着 往 下 做 。 学 习 处 理 蜡 常 
可 帮助 你 应 对 文件 不 存在 的 情形 ,以 及 处 理 其 他 可 能 导致 程序 崩溃 的 问题 。 这 让 你 的 程序 在 
面 对 错 误 的 数据 时 更 健壮 不 管 这 些 错 误 数 据 源 自 无 意 的 错误 , 还 是 源 自 破坏 程序 的 恶意 
企图 。 你 在 本 章 学 习 的 技能 可 提高 程序 的 适用 性 、 可 用 性 和 稳定 性 。 


10.1 从 文件 中 读 取 数据 


文本 文件 可 存储 的 数据 量 多 得 难以 置信 : 天 气 数据 、 交 通 数 据 、 社 会 经 济 数据 、 文 学 作品 等 。 
每 当 需 要 分 析 或 修改 存储 在 文件 中 的 信息 时 , 读 取 文件 都 很 有 用 , 对 数据 分 析 应 用 程序 来 说 尤其 
如 此 。 例 如 ,你 可 以 编写 一 个 这 样 的 程序 : 读 取 一 个 文本 文件 的 内 容 , 重新 设置 这 些 数据 的 格式 
并 将 其 写 入 文件 ， 让 浏览 絮 能 够 显示 这 些 内 容 。 

要 使 用 文本 文件 中 的 信息 ,首先 需要 将 信息 读 取 到 内 存 中 。 为 此 ,你 可 以 一 次 性 读 取 文件 的 
全 部 内 容 ， 也 可 以 以 每 次 一 行 的 方式 逐步 读 取 。 


10.1.1 读 取 整个 文件 


要 读 取 文件 , 需要 一 个 包含 几 行 文本 的 文件 。 下 面 首先 来 创建 一 个 文件 , 它 包 含 精 确 到 小 数 
点 后 30 位 的 圆周 率 值 ， 且 在 小 数 点 后 每 10 位 处 都 换行 : 
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pi_digits.txt 


3.1415926535 
8979323846 
2643383279 


要 动手 尝试 后 续 示 例 ， 可 在 编辑 器 中 输入 这 些 数据 行 ， 再 将 文件 保存 为 pi_digits.txt， 也 可 从 
本 书 的 配套 网 站 (https:/www.nostarch.com/pythoncrashcourse/ ) 下 载 该 文件 。 然 后 ， 将 该 文件 保 
存 到 本 章程 序 所 在 的 目录 中 。 

下 面 的 程序 打开 并 读 取 这 个 文件 ， 再 将 其 内 容 显示 到 屏幕 上 : 


file_reader.py 


with open('pi digits.txt') as file object: 
contents = file object.read() 
print(contents) 


在 这 个 程序 中 ， 第 1 行 代码 做 了 大 量 的 工作 。 我 们 先 来 看 看 函数 open()。 要 以 任何 方式 使 用 
文件 一 一 哪怕 仅仅 是 打印 其 内 容 , 都 得 先 打 开 文 件 , 这 样 才能 访问 它 。 函数 open() 接 受 一 个 参数 . 
要 打开 的 文件 的 名 称 。Python 在 当前 执行 的 文件 所 在 的 目录 中 查找 指定 的 文件 。 在 这 个 示例 中 ， 
当前 运行 的 是 file readerpy, 因此 Python 在 file_reader.py 所 在 的 目录 中 查找 pi_digits.txt。 因数 open() 
返回 一 个 表示 文件 的 对 象 。 在 这 里 , open('pi digits.txt') 返 回 一 个 表示 文件 pi digits.txt 的 对 
象 ; Python 将 这 个 对 象 存储 在 我 们 将 在 后 面 使 用 的 变量 中 。 

关键 字 with 在 不 再 需要 访问 文件 后 将 其 关闭 。 在 这 个 程序 中 ， 注 意 到 我 们 调用 了 open(), 但 
没有 调用 close(); 你 也 可 以 调用 open() 和 close() 来 打开 和 关闭 文件 ， 但 这 样 做 时 ， 如 果 程 序 存 
在 bug， 导 致 close() 语 名 未 执行 ,文件 将 不 会 关闭 。 这 看 似 微不足道 ， 但 未 妥善 地 关闭 文件 可 能 
会 导致 数据 丢失 或 受 损 。 如 果 在 程序 中 过 早 地 调用 close() ， 你 会 发 现 需要 使 用 文件 时 它 已 关闭 
(无 法 访问 ), 这 会 导致 更 多 的 错误 。 并 非 在 任何 情况 下 都 能 轻松 确定 关闭 文件 的 恰当 时 机 , 但 通 
过 使 用 前 面 所 示 的 结构 ， 可 让 Python 去 确定 : 你 只 管 打 开 文 件 ， 并 在 需要 时 使 用 它 ，Python 自 会 
在 合适 的 时 候 自 动 将 其 关闭 。 

有 了 表示 pi_digits.txt 的 文件 对 象 后 ， 我 们 使 用 方法 read()( 前 述 程序 的 第 2 行 ) 读 取 这 个 文 
件 的 全 部 内 容 ， 并 将 其 作为 一 个 长 长 的 字符 串 存 储 在 变量 contents 中 。 这 样 ， 通 过 打印 contents 
的 值 ， 就 可 将 这 个 文本 文件 的 全 部 内 容 显示 出 来 : 

3.1415926535 


8979323846 
2643383279 


相 比 于 原始 文件 , 该 输出 唯一 不 同 的 地 方 是 末尾 多 了 一 个 空 行 。 为 何 会 多 出 这 个 空 行 呢 ? 
为 read() 到 达 文 件 末尾 时 返回 一 个 空 字 符 串 ,而 将 这 个 空 字 符 串 显示 出 来 时 就 是 一 个 空 行 。 要 删 
除 多 出 来 的 空 行 ， 可 在 print 语 句 中 使 用 rstrip(): 
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with open('pi digits.txt') as file object: 
contents = file object.read() 
print(contents.rstrip()) 


本 书 前 面 说 过 ，Python 方 法 rstrip() 删 除 ( 剥 除 ) 字符 串 末 尾 的 空 日 。 现 在 ,输出 与 原始 文 
件 的 内 容 完全 相同 : 
3.1415926535 


8979323846 
2643383279 


10.1.2 ”文件 路 径 


当 你 将 类 似 pi_digits.txt 这 样 的 简单 文件 名 传递 给 函数 open() 时 ，Python 将 在 当前 执行 的 文件 
( 即 .py 程序 文件 ) 所 在 的 目录 中 查找 文件 。 

根据 你 组 织 文件 的 方式 ， 有 时 可 能 要 打开 不 在 程序 文件 所 属 目录 中 的 文件 。 例 如 ， 你 可 能 将 
程序 文件 存储 在 了 文件 夹 python _ work 中 ， 而 在 文件 夹 python_work 中 ， 有 一 个 名 为 text_files 的 文 
件 夹 , 用 于 存储 程序 文件 操作 的 文本 文件 。 虽然 文件 夹 text_files 包 含 在 文件 夹 python_work 中 , 但 
仅 向 open() 传 递 位 于 该 文件 夹 中 的 文件 的 名 称 也 不 可 行 , 因为 Python 只 在 文件 夹 python_work 中 查 
找 ， 而 不 会 在 其 子 文 件 夹 text files 中 查找 。 要 让 Python 打开 不 与 程序 文件 位 于 同一 个 目录 中 的 文 
件 ， 需 要 提供 文件 路 径 ， 它 让 Python 到 系统 的 特定 位 置 去 查找 。 

由 于 文件 夹 text_files 位 于 文件 夹 python _ work 中 , 因此 可 使 用 相对 文件 路 径 来 打开 该 文件 夹 中 
的 文件 。 相 对 文件 路 径 让 Python 到 指定 的 位 置 去 查找 ， 而 该 位 置 是 相对 于 当前 运行 的 程序 所 在 目 
录 的 。 在 Linux 和 OS X 中 ， 你 可 以 这 样 编写 代码 


with open( "text files/fi7lename.txt') as file object: 


这 行 代码 让 Python 到 文件 夹 python_work 下 的 文件 夹 text_files 中 去 查找 指定 的 .txt 文 件 。 在 
Windows 系 统 中 ， 在 文件 路 径 中 使 用 反 斜 杠 〈\ ) 而 不 是 斜 杠 ( / ): 


with open('text files\fi7ename.txt') as file object: 


你 还 可 以 将 文件 在 计算 机 中 的 准确 位 置 告诉 Python， 这 样 就 不 用 关心 当前 运行 的 程序 存储 在 
什么 地 方 了 。 这 称 为 绝对 文件 路 径 。 在 相对 路 径 行 不 通 时 , 可 使 用 绝对 路 径 。 例 如 , 如果 text_files 
并 不 在 文件 夹 python work 中 ， 而 在 文件 夹 other files 中 ， 则 向 open() 传 递 路 径 'text files/ 
filename.txt ' 行 不 通 ， 因 为 Python 只 在 文件 夹 python work 中 查找 该 位 置 。 为 明确 地 指出 你 希望 
Python 到 哪里 去 查找 ， 你 需要 提供 完整 的 路 径 。 

绝对 路 径 通 常 比 相对 路 径 更 长 ， 因 此 将 其 存储 在 一 个 变量 中 ,再 将 该 变量 传递 给 open() 会 有 
所 帮助 。 在 Linux 和 OS X 中 ， 绝 对 路 径 类 似 于 下 面 这 样 : 


10.1 从 文件 中 读 取 数 据 165 


file _ path = '/home/ehmatthes/other files/text files/filename.txt' 
with open(file path) as file object: 


而 在 Windows 系 统 中 ， 它 们 类 似 于 下 面 这 样 : 


file path = 'C:\Users\ehmatthes\other files\text files\fi7lename.txt' 
with open(file path) as file object: 


通过 使 用 绝对 路 径 ， 可 读 取 系统 任何 地 方 的 文件 。 就 目前 而 言 ， 最 简单 的 做 法 是 ， 要 么 将 数 
据 文件 存储 在 程序 文件 所 在 的 目录 ， 要 么 将 其 存储 在 程序 文件 所 在 目录 下 的 一 个 文件 夹 〈 如 
text files ) 中 。 


注意 Windows 系 统 有 时 能 够 正确 地 解读 文件 路 径 中 的 斜 杠 。 如 果 你 使 用 的 是 Windows 系 统 ， 且 
结果 不 符合 预期， 请 确保 在 文件 路 径 中 使 用 的 是 反 斜 杠 ， 


10.1.3 ”了 逐 行 读 取 


读 取 文件 时 ， 常 常 需要 检查 其 中 的 每 一 行 : 你 可 能 要 在 文件 中 查找 特定 的 信息 ,或 者 要 以 
某 种 方式 修改 文件 中 的 文本 。 例 如 ， 你 可 能 要 遍历 一 个 包含 天 气 数据 的 文件 ， 并 使 用 天 气 描述 
中 包含 字样 sunny 的 行 。 在 新 闻 报 道中 ， 你 可 能 会 查找 包含 标签 cheadline> 的 行 ， 并 按 特定 的 格 
式 设置 它 。 

要 以 每 次 一 行 的 方式 检查 文件 ， 可 对 文件 对 象 使 用 for 循 环 : 


file_reader.py 


@ filename = 'pi digits.txt' 


@ with open(filename) as file object: 
(3 for line in file object: 
print(line) 


在 @ 处 ， 我 们 将 要 读 取 的 文件 的 名 称 存储 在 变量 filename 中 ， 这 是 使 用 文件 时 一 种 常见 的 做 
法 。 由 于 变量 filename 表 示 的 并 非 实 际 文件 一 一 它 只 是 一 个 让 Python 知道 到 哪里 去 查找 文件 的 字 
符 串 ， 因 此 可 轻松 地 将 'pi_digits.txt ' 替 换 为 你 要 使 用 的 另 一 个 文件 的 名 称 。 调 用 open() 后 , 将 
一 个 表示 文件 及 其 内 容 的 对 象 存储 到 了 变量 file_object 中 ( 见 @ )。 这 里 也 使 用 了 关键 字 with， 
让 Python 负责 妥善 地 打开 和 关闭 文件 。 为 查看 文件 的 内 容 ,， 我 们 通过 对 文件 对 象 执行 循环 来 遍历 
文件 中 的 每 一 行 ( 见 @ )。 

我 们 打印 每 一 行 时 ， 发 现 空白 行 更 多 了 : 


3.1415926535 


8979323846 
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2643383279 


为 何 会 出 现 这 些 空白 行 呢 ? 因为 在 这 个 文件 中 ， 每 行 的 末尾 都 有 一 个 看 不 见 的 换行 符 ， 而 
print 语 句 也 会 加 上 一 个 换行 符 , 因此 每 行 末 尾 都 有 两 个 换行 符 : 一 个 来 自 文 件 , 男 一 个 来 自 print 
语句 。 要 消除 这 些 多 余 的 空白 行 ， 可 在 print 语 句 中 使 用 rstrip(): 


filename = 'pi digits.txt" 


with open(filename) as 


file object: 


for line in file object: 
print(line.rstrip()) 


现在 ,输出 又 与 文件 内 容 完全 相同 了 : 


3.1415926535 
8979323846 
2643383279 


10.1.4 创建 一 个 包含 文件 各 行内 容 的 列表 


使 用 关键 字 with 时 
访问 文件 的 内 容 ， 可 在 


列表 : 你 可 以 立即 处 理 文件 的 各 个 部 分 ， 也 可 推迟 到 程序 后 面 再 处 理 。 


下 面 的 示例 在 with 
打印 它们 : 


，open() 返 回 的 文件 对 象 只 在 with 代码 块 内 可 用 。 如 果 要 在 with 代码 块 外 
with 代码 块 内 将 文件 的 各 行 存储 在 一 个 列表 中 ,并 在 with 代码 块 外 使 用 该 


代码 块 中 将 文件 pi_digits.txt 的 各 行 存储 在 一 个 列表 中 ， 再 在 with 代码 块 外 


filename = 'pi digits 


with open(filename) 


@ lines = file obj 


@ for line in lines: 


txt" 


as file object: 
ect.readlines() 


print(line.rstr 


ip()) 


@ 处 的 方法 readlines() 从 文件 中 读 取 每 一 行 , 并 将 其 存储 在 一 个 列表 中 ; 接 下 来 , 该 列表 被 
存储 到 变量 lines 中 ; 在 with 代码 块 外 , 我 们 依然 可 以 使 用 这 个 变量 。 在 @ 处 , 我 们 使 用 一 个 简单 


的 for 循 环 来 打印 lines 
与 文件 内 容 完全 一 致 。 


中 的 各 行 。 由 于 列表 lines 的 每 个 元 素 都 对 应 于 文件 中 的 一 行 ， 因 此 输出 


10.1.5 ”使 用 文件 的 内 容 
将 文件 读 取 到 内 存 中 后 , 就 可 以 以 任何 方式 使 用 这 些 数据 了 。 下 面 以 简单 的 方式 使 用 圆周 率 


的 值 。 首 先 ， 我 们 将 创 


建 一 个 字符 串 ， 它 包含 文件 中 存储 的 所 有 数字 ， 且 没有 任何 空格 : 
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pi_string.py 


filename = “pi digits.txt' 


with open(filename) as file object: 
lines = file object.readlines() 


@ pi string = "" 
@ for line in lines: 
pi string += line.rstrip() 


@ print(pi string) 
print(len(pi string)) 
就 像 前 一 个 示例 一 样 , 我 们 首先 打开 文件 , 并 将 其 中 的 所 有 行 都 存储 在 一 个 列表 中 。 在 @ 处 ， 
我 们 创建 了 一 个 变量 一 一 pi_string， 用 于 存储 圆周 率 的 值 。 接 下 来 ,我们 使 用 一 个 循环 将 各 行 
都 加 入 pi_string， 并 删除 每 行 末尾 的 换行 符 〈 见 @ )。 在 @ 处 ,我 们 打印 这 个 字符 串 及 其 长 度 : 


3.1415926535 8979323846 2643383279 
36 


在 变量 pi_string 存 储 的 字符 串 中 ， 包 含 原来 位 于 每 行 左边 的 空格 ， 为 删除 这 些 空格 ， 可 使 
用 strip() 而 不 是 rstrip(): 


filename = 'pi 30 digits.txt' 


with open(filename) as file object: 
lines = file object.readlines() 


pi string = "" 
for line in lines: 
pi_string += line.strip() 


print(pi string) 
print(len(pi string)) 


这 样 ,我 们 就 获得 了 一 个 这 样 的 字符 串 : 它 包含 精确 到 30 位 小 数 的 圆周 率 值 。 这 个 字符 串 长 
32 字 符 ， 因 为 它 还 包含 整数 部 分 的 3 和 人 小数点: 


3.141592653589793238462643383279 
32 


注意 读 取 文本 文件 时 ，Python 将 其 中 的 所 有 文本 都 解读 为 字符 串 。 如 果 你 读 取 的 是 数字 ， 并 
要 将 其 作为 数值 使 用 , 就 必须 使 用 兄 数 int() 将 其 转换 为 整数 , 或 使 用 函数 fo0at() 将 其 转 
换 为 浮 点 数 。 
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10.1.6 包含 一 百 万 位 的 大 型 文件 


前 面 我 们 分 析 的 都 是 一 个 只 有 三 行 的 文本 文件 ， 但 这 些 代码 示例 也 可 处 理 大 得 多 的 文件 。 
如 果 我 们 有 一 个 文本 文件 ， 其 中 包含 精确 到 小 数 点 后 1 000 000 位 而 不 是 30 位 的 圆周 率 值 ， 也 可 
创建 一 个 包含 所 有 这 些 数字 的 字符 串 。 为 此 ， 我 们 无 需 对 前 面 的 程序 做 任何 修改 ， 只 需 将 这 个 
文件 传递 给 它 即 可 。 在 这 里 ， 我 们 只 打印 到 小 数 点 后 30 位， 以 免 终 端 为 显示 全 部 1 000 000 位 而 


pi_string.py 


filename = “pi million digits.txt 


with open(filename) as file object: 
lines = file object.readlines() 
pi string 
for line in lines: 
pi string += line.strip() 
print(pi string[:52] + "...") 
print(len(pi string)) 


输出 表明 ， 我 们 创建 的 字符 串 确实 包含 精确 到 小 数 点 后 1 000 000 位 的 圆周 率 值 : 


3.14159265358979323846264338327950288419716939937510... 
1000002 


对 于 你 可 处 理 的 数据 量 ，Python 没 有 任何 限制 ; 只 要 系统 的 内 存 足 够 多 ,你 想 处 理 多 少数 据 
都 可 以 。 


注意 ”要 运行 这 个 程序 ( 以 及 后 面 的 众多 示例 )， 你 需要 从 https://www.nostarch.com/pythoncra- 
shcourse/ 下 载 相关 的 资源 。 


10.1.7 ”圆周率 值 中 包含 你 的 生日 吗 


我 一 直 想 知道 自己 的 生日 是 否 包 含 在 圆周 率 值 中 。 下 面 来 扩展 刚才 编写 的 程序 ， 以 确定 某 个 
人 的 生日 是 否 包含 在 圆周 率 值 的 前 1 000 000 位 中 。 为 此 ,可 将 生日 表示 为 一 个 由 数字 组 成 的 字符 
串 ， 再 检查 这 个 字符 串 是 否 包 含 在 pi_string 中 : 


filename = “pi million digits.txt 


with open(filename) as file object: 
lines = file object.readlines() 
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pi string 
for line in lines: 
pi string += line.rstrip() 


@ birthday = input("Enter your birthday, in the form mmddyy: ") 
@ if birthday in pi string: 
print("Your birthday appears in the first million digits of pi!") 
else: 
print("Your birthday does not appear in the first million digits of pi.") 


在 @ 人 处， 我 们 提示 用 户 输入 其 生日 ， 在 接 下 来 的 @ 人 处 ,我们 检查 这 个 字符 串 是 否 包 含 在 
pi_string 中 。 运 行 一 下 这 个 程序 : 


Enter your birthdate, in the form mmddyy: 120372 
Your birthday appears in the first million digits of pil 


我 的 生日 确实 出 现在 了 圆周 率 值 中 ! 读 取 文 件 的 内 容 后 , 就 可 以 以 你 能 想到 的 任何 方式 对 其 
进行 分 析 。 


动手 试 一 斌 

10-1 Python 学 习 笔记 : 在 文本 编辑 器 中 新 建 一 个 文件 ， 写 几 和 句 话 来 总 结 一 下 你 至 

此 学 到 的 Python 知识 ， 其 中 每 一 行 都 以 “In Python you can” 打 头 。 将 这 个 文件 命名 为 

learning python.txt， 并 将 其 存储 到 为 完成 本 章 练习 而 编写 的 程序 所 在 的 目录 中 。 编写 一 

个 程序 ， 它 读 取 这 个 文件 ， 并 将 你 所 写 的 内 容 打 印 三 次 : 第 一 次 打印 时 读 取 整 个 文件 ; 

第 二 次 打印 时 遍历 文件 对 象 ; 第 三 次 打印 时 将 各 行 存储 在 一 个 列表 中 ， 再 在 with 代码 
块 外 打印 它们 。 


10-2 C 语言 学 习 笔 记 : 可 使 用 方法 replace() 将 字符 串 中 的 特定 单词 都 蔡 换 为 另 一 
个 单词 。 下 面 是 一 个 简单 的 示例 ， 演 示 了 如 何 将 句子 中 的 'dog ' 替 换 为 "cat': 


>>> message = "I really like dogs." 
>>> message.replace('dog', 'cat') 
'I really like cats.’ 


读 取 你 刚 创建 的 文件 learning python.txt 中 的 每 一 行 ， 将 其 中 的 Python 都 替换 为 另 
一 门 语言 的 名 称 ， 如 C。 将 修改 后 的 各 行 都 打印 到 屏 慕 上 。 


10.2 写 入 文件 


保存 数据 的 最 简单 的 方式 之 一 是 将 其 写 入 到 文件 中 。 通过 将 输出 写 入 文件 , 即便 关闭 包含 程 
序 输出 的 终端 窗口 ， 这 些 输出 也 依然 存在 : 你 可 以 在 程序 结束 运行 后 查看 这 些 输 出 ， 可 与 别人 分 
享 输出 文件 ， 还 可 编写 程序 来 将 这 些 输出 读 取 到 内 存 中 并 进行 处 理 。 
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10.2.1 写 入 空 文件 


要 将 文本 写 入 文件 ， 你 在 调用 open() 时 需要 提供 男 一 个 实 参 ， 告 诉 Python 你 要 写 入 打开 的 文 
件 。 为 明白 其 中 的 工作 原理 , 我 们 来 将 一 条 简单 的 消息 存储 到 文件 中 , 而 不 是 将 其 打印 到 屏幕 上 : 


write_message.py 


filename = “pogTammjing.txt 


@ with open(filename, 'w') as file object: 
@ file object.write("I love programming.") 


在 这 个 示例 中 , 调用 open() 时 提供 了 两 个 实 参 ( 见 @ ), 第 一 个 实 参 也 是 要 打开 的 文件 的 名 称 ; 
第 二 个 实 参 ('w' ) 告诉 Python， 我 们 要 以 写 入 模式 打开 这 个 文件 。 打 开 文 件 时 ， 可 指定 读 取 模 
式 ('r' )、 写 入 模式 ('w' )、 附 加 模式 ('a' ) 或 让 你 能 够 读 取 和 写 入 文件 的 模式 ('r+' )。 如 果 
你 省 略 了 模式 实 参 ，Python 将 以 默认 的 只 读 模 式 打开 文件 。 

如 果 你 要 写 入 的 文件 不 存在 ， 函 数 open() 将 自动 创建 它 。 然 而 ， 以 写 入 〈'w' ) 模式 打开 文 
件 时 千 万 要 小 心 ， 因 为 如 果 指 定 的 文件 已 经 存在 ，Python 将 在 返回 文件 对 象 前 清空 该 文件 。 

在 @ 处 ,我 们 使 用 文件 对 象 的 方法 write() 将 一 个 字符 串 写 入 文件 。 这 个 程序 没有 终端 输出 ， 
但 如 果 你 打开 文件 programming.txt， 将 看 到 其 中 包含 如 下 一 行内 容 : 


programming.txt 


I love programming. 


相 比 于 你 的 计算 机 中 的 其 他 文件 ,这 个 文件 没有 什么 不 同 。 你 可 以 打开 它 、 在 其 中 输入 新 文 
本 、 复 制 其 内 容 、 将 内 容 粘贴 到 其 中 等 。 


注意 ”Python 只 能 将 字符 囊 写 入 文本 文件 。 要 将 数值 数据 存储 到 文本 文件 中 ， 必 须 先 使 用 函数 
str() 将 其 转换 为 字符 串 格 式 。 


10.2.2 写 入 多 行 


函数 write() 不 会 在 你 写 入 的 文本 末尾 添加 换行 符 , 因此 如 果 你 写 入 多 行 时 没有 指定 换行 符 ， 
文件 看 起 来 可 能 不 是 你 希望 的 那样 : 


filename = 'programming.txt" 


with open(filename, 'w') as file object: 
file object.write("I love programming.") 
file object.write("I love creating new games.") 
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如 果 你 打开 programming.txt， 将 发 现 两 行内 容 撞 在 一 起 : 


I love programming.I love creating new games. 


要 让 每 个 字符 串 都 单独 占 一 行 ， 需 要 在 write() 语 句 中 包含 换行 符 : 


filename = “programming .txt” 


with open(filename, 'w') as file object: 
file object.write("I love programming.\n") 
file object.write("I love creating new games.\n") 


现在 ， 输 出 出 现在 不 同行 中 : 


I love programming. 
I love creating new games. 


像 显示 到 终端 的 输出 一 样 ， 还 可 以 使 用 空格 、 制 表 符 和 空 行 来 设置 这 些 输出 的 格式 。 
10.2.3 ”附加 到 文件 


如 果 你 要 给 文件 添加 内 容 , 而 不 是 覆盖 原 有 的 内 容 ， 可 以 附加 模式 打开 文件 。 你 以 附加 模式 
打开 文件 时 , Python 不 会 在 返回 文件 对 象 前 清空 文件 , 而 你 写 人 到 文件 的 行 都 将 添加 到 文件 未 尾 。 
如 果 指 定 的 文件 不 存在 ，Python 将 为 你 创建 一 个 空 文件 。 

下 面 来 修改 write_ message.py， 在 既 有 文件 programming.txt 中 再 添加 一 些 你 酷爱 编程 的 原因 : 


write_message.py 


filename = “programming .txt 


@ with open(filename, 'a') as file object: 
@ file object.write("I also love finding meaning in large datasets.\n") 
file object.write("I love creating apps that can run in a browser.\n") 


在 @ 人 处 ， 我 们 打开 文件 时 指定 了 实 参 'a' ， 以 便 将 内 容 附 加 到 文件 末尾 ， 而 不 是 覆盖 文件 原 
来 的 内 容 。 在 四 处 ， 我 们 又 写 入 了 两 行 ， 它 们 被 添加 到 文件 programming.txt 未 尾 : 


programming.txt 


love programming. 

love creating new games. 

also love finding meaning in large datasets. 
love creating apps that can run in a browser. 


上 上 上 上 


最 终 的 结果 是 ,文件 原来 的 内 容 还 在 ,它们 后 面 是 我 们 刚 添加 的 内 容 。 
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动手 试 一 试 
10-3 访客 : 编写 一 个 程序 ， 提示 用 户 输入 其 名 字 ; 用 户 作 出 响应 后 ， 将 其 名 字 
入 到 文件 guest.txt 中 。 
10-4 访客 名 单 : 编写 一 个 while 循环 ， 提 示 用 户 输入 其 名 字 。 用 户 输入 其 名 字 后 ， 


在 屏幕 上 打印 一 句 问候 语 ， 并 将 一 条 访问 记录 添加 到 文件 guest book.txt 中 。 确 保 这 个 
文件 中 的 每 条 记录 都 独占 一 行 。 

10-5 关于 编程 的 调查 : 编写 一 个 while 循环 , 询问 用 户 为 何 喜欢 编程 。 每 当 用 户 输 
入 一 个 原因 后 ， 都 将 其 添加 到 一 个 存储 所 有 原因 的 文件 中 。 


10.3 “异常 


Python 使 用 被 称 为 异常 的 特殊 对 象 来 管理 程序 执行 期 间 发 生 的 错误 。 每 当 发 生 让 Python 不 知 
所 措 的 错误 时 ， 它 都 会 创建 一 个 异常 对 象 。 如 果 你 编写 了 处 理 该 异常 的 代码 ， 程 序 将 继续 运行 ; 
如 果 你 未 对 异常 进行 处 理 ， 程 序 将 停止 ， 并 显示 一 个 traceback， 其 中 包含 有 关 异 常 的 报告 。 

异常 是 使 用 try-except 代 码 块 处 理 的 。try-except 代 码 块 计 Python 执 行 指定 的 操作 ， 同 时 告 
诉 Python 发 生 异 常 时 怎么 办 。 使 用 了 try-except 代 码 块 时 ， 即 便 出 现 异常 ， 程 序 也 将 继续 运行 : 
显示 你 编写 的 友好 的 错误 消息 ， 而 不 是 令 用 户 迷 惑 的 traceback。 


10.3.1 处理 ZeroDivisionError 异常 


下 面 来 看 一 种 导致 Python 引发 异常 的 简单 错误 。 你 可 能 知道 不 能 将 一 个 数字 除 以 0， 但 我 们 
是 让 Python 这 样 做 吧 ; 


六 


division.py 


print(5/0) 


显然 ，Python 无 法 这 样 做 ， 因 此 你 将 看 到 一 个 traceback: 


Traceback (most recent call last): 
File "division.py", line 1, in <module> 
print(5/0) 
@ ZeroDivisionError: division by zero 


在 上 述 traceback 中 ，@ 处 指出 的 错误 ZeroDivisionError 是 一 个 异常 对 象 。Python 无 法 按 你 的 
要 求 做 时 , 就 会 创建 这 种 对 象 。 在 这 种 情况 下 ,Python 将 停止 运行 程序 , 并 指出 引发 了 哪 种 异常 ， 
而 我 们 可 根据 这 些 信息 对 程序 进行 修改 。 下面 我 们 将 告诉 Python, 发 生 这 种 错误 时 怎么 办 ; 这 样 ， 
如 果 再 次 发 生 这 样 的 错误 ， 我们 就 有 备 无 患 了 。 


10.3.2 ”使 用 try-except 代码 块 

当 你 认为 可 能 发 生 了 错误 时 ， 可 编写 一 个 try-except 代 码 块 来 处 理 可 能 引发 的 异常 。 你 让 
Python 尝试 运行 一 些 代 码 ， 并 告诉 它 如 果 这 些 代码 引发 了 指定 的 异常 ， 该 怎么 办 。 

处 理 ZeroDivisionError 异 常 的 try-except 代 码 块 类 似 于 下 面 这 样 : 


try: 
print(5/0) 
except ZeroDivisionError: 
print("You can't divide by zero!") 


我 们 将 导致 错误 的 代码 行 print(5/0) 放 在 了 一 个 try 代 码 块 中 。 如 果 try 代 码 块 中 的 代码 运行 
起 来 没有 问题 ，Python 将 跳 过 except 代 码 块 ; 如 果 try 代 码 块 中 的 代码 导致 了 错误 ，Python 将 查找 
这 样 的 except 代 码 块 ， 并 运行 其 中 的 代码 ， 即 其 中 指定 的 错误 与 引发 的 错误 相同 。 
在 这 个 示例 中 ，try 代 码 块 中 的 代码 引发 了 ZeroDivisionError 异 常 ， 因 此 Python 指 出 了 该 如 
何 解 决 问题 的 except 代 码 块 ， 并 运行 其 中 的 代码 。 这 样 ， 用 户 看 到 的 是 一 条 友好 的 错误 消息 ,而 
不 是 traceback: 


证 


You can't divide by zero! 


如 果 try-except 代 码 块 后 面 还 有 其 他 代码 ， 程 序 将 接着 运行 ， 因 为 已 经 告诉 了 Python 如 何 处 
理 这 种 错误 。 下 面 来 看 一 个 捕获 错误 后 程序 将 继续 运行 的 示例 。 


10.3.3 ”使 用 异常 避免 于 省 

发 生 错误 时 ， 如 果 程 序 还 有 工作 没有 完成 ,妥善 地 处 理 错误 就 尤其 重要 。 这 种 情况 经 常会 出 
现在 要 求 用 户 提供 输入 的 程序 中 ; 如 果 程 序 能 够 妥善 地 处 理 无 效 输入 ,就 能 再 提示 用 户 提 供 有 效 
输入 ， 而 不 至 于 崩溃 。 

下 面 来 创建 一 个 只 执行 除法 运算 的 简单 计算 器 : 


division.py 


print("Give me two numbers, and I'11 divide them.") 
print("Enter 'q' to quit.") 


while True: 
© first number = input("\nFirst number: ") 
if first number == 'q": 
break 
@ second number = input("Second number: ") 
if second number == 'q : 
break 
日 answer = int(first number) / int(second number) 
print(answer) 
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在 @ 处 ， 这 个 程序 提示 用 户 输入 一 个 数字 ， 并 将 其 存储 到 变量 first_numper 中 ; 如 果 用 户 输 
入 的 不 是 表示 退出 的 q, 就 再 提示 用 户 输入 一 个 数字 , 并 将 其 存储 到 变量 second_numper 中 ( 见 @ )。 
接 下 来 ,我们 计算 这 两 个 数字 的 商 ( 即 answer， 见 @ )。 这 个 程序 没有 采取 任何 处 理 错 误 的 措施 ， 
因此 让 它 执 行 除数 为 0 的 除法 运算 时 ， 它 将 表演 : 


Give me two numbers, and I 11 divide them. 
Enter 'q' to quit. 


First number: 5 
Second number: 0 
Traceback (most recent call last): 
File "division.py", line 9, in <module> 
answer = int(first number) / int(second number) 
ZeroDivisionError: division by zero 


程序 崩溃 可 不 好 ， 但 让 用 户 看 到 traceback 也 不 是 好 主意 。 不 懂 技 术 的 用 户 会 被 它们 搞 糊 涂 ， 
而 且 如 果 用 户 怀 有 恶意 ， 他 会 通过 traceback 获 悉 你 不 希望 他 知道 的 信息 。 例 如 ， 他 将 知道 你 的 程 
序 文件 的 名 称 ， 还 将 看 到 部 分 不 能 正确 运行 的 代码 。 有 时 候 , 训练 有 素 的 攻击 者 可 根据 这 些 信息 
判断 出 可 对 你 的 代码 发 起 什么 样 的 攻击 。 


10.3.4 else 代码 块 

通过 将 可 能 引发 错误 的 代码 放 在 try-except 代 码 块 中 ， 可 提高 这 个 程序 抵御 错误 的 能 力 。 错 
误 是 执行 除法 运算 的 代码 行 导致 的 ， 因 此 我 们 需要 将 它 放 到 try-except 代 码 块 中 。 这 个 示例 还 包 
含 一 个 else 代 码 块 ; 依赖 于 try 代 码 块 成 功 执行 的 代码 都 应 放 到 else 代 码 块 中 : 


print("Give me two numbers, and I'1] divide them.") 
print("Enter 'q' to quit.") 


while True: 
first number = input("\nFirst number: ") 
if first number 3 
break 
second number = input("Second number: ") 
@ try: 
answer = int(first number) / int(second number) 
@ except ZeroDivisionError: 
print("You can't divide by 0!1") 
3 else: 
print(answer) 


我 们 让 Python 尝 试 执行 try 代 码 块 中 的 除法 运算 ( 见 @ )， 这 个 代码 块 只 包含 可 能 导致 错误 的 
代码 。 依 赖 于 try 代 码 块 成 功 执 行 的 代码 都 放 在 else 代 码 块 中 ; 在 这 个 示例 中 ， 如 果 除 法 运算 成 
功 ， 我 们 就 使 用 else 代 码 块 来 打印 结果 ( 见 @ )。 

except 代 码 块 告诉 Python ， 出 现 zeroDivisionError 异 常 时 该 怎么 办 ( 见 @ )。 如 果 try 代 码 块 
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因 除 零 错 误 而 失败 , 我 们 就 打印 一 条 友好 的 消息 , 告诉 用 户 如 何 避 免 这 种 错误 。 程 序 将 继续 运行 ， 


用 户 根本 看 不 到 traceback: 


Give me two numbers, and I 11 divide them. 
Enter 'q' to quit. 


First number: 5 
Second number: 0 
You can't divide by 0! 


First number: 5 
Second number: 2 


2.5 


First number: q 


try-except-else 代 码 块 的 工作 原理 大 致 如 下 : Python 尝 试 执行 try 代 码 块 中 的 代码 ; 只 有 可 
能 引发 异常 的 代码 才 需 要 放 在 try 语 句 中 。 有 时 候 ， 有 一 些 仅 在 try 代 码 块 成 功 执行 时 才 需 要 运行 


的 代码 ; 这 些 代码 应 放 在 else 代 码 块 中 。exce 
的 代码 时 引发 了 指定 的 异常 ， 该 怎么 办 。 


pt 代码 块 告诉 Python， 如 果 它 尝试 运行 try 代 码 块 中 


通过 预测 可 能 发 生 错误 的 代码 ,可 编写 健壮 的 程序 ,它们 即便 面临 无 效 数 据 或 缺少 资源 ,也 


能 继续 运行 ， 从 而 能 够 抵御 无 意 的 用 户 错误 条 


10.3.5 ”处 理 FileNotFoundError 异常 


[恶意 的 攻击 。 


使 用 文件 时 , 一 种 常见 的 问题 是 找 不 到 文件 : 你 要 查找 的 文件 可 能 在 其 他 地 方 、 文 件 名 可 能 


不 正确 或 者 这 个 文件 根本 就 不 存在 。 对 于 所 有 这 些 情形 ， 都 可 使 用 try-except 代 码 块 以 直观 的 方 


式 进行 处 理 。 


我 们 来 尝试 读 取 一 个 不 存在 的 文件 。 下 面 的 程序 尝试 读 取 文 件 alice.txt 的 内 容 ， 但 我 没有 将 


这 个 文件 存储 在 alice.py 所 在 的 目录 中 : 


alice.py 


filename = "alice.txt' 


with open(filename) as f obj: 
contents = f obj.read() 


上 和 开 而 : 


Python 无 法 读 取 不 存在 的 文件 ， 因 此 它 引发 一 个 异 党 


Traceback (most recent call last): 
File "alice.py", line 3, in <module> 
with open(filename) as f obj: 


FileNotFoundError: [Errno 2] No such file or directory: 'alice.txt' 


在 上 述 traceback 中 ， 最 后 一 行 报 告 了 FileNotFoundError 异 常 ， 这 是 Python 找 不 到 要 打开 的 文 


176 第 10 章 “文件 和 异常 


件 时 创建 的 异常 。 在 这 个 示例 中 ， 这 个 错误 是 函数 open() 导 致 的 ， 因 此 要 处 理 这 个 错误 ， 必 须 将 
try 语 句 放 在 包含 open() 的 代码 行 之 前 : 


filename = 'alice.txt" 


ty 
with open(filename) as f obj: 
contents = f obj.read() 
except FileNotFoundError: 
msg = "Sorry, the file ”+ filename + ”does not exist." 
print(msg) 


在 这 个 示例 中 ，try 代 码 块 引发 FileNotFoundError 异 常 ， 因 此 Python 找 出 与 该 错误 匹配 的 
except 代 码 块 ， 并 运行 其 中 的 代码 。 最 终 的 结果 是 显示 一 条 友好 的 错误 消息 ， 而 不 是 traceback: 


Sorry, the file alice.txt does not exist. 


如 果 文 件 不 存在 ,这 个 程序 什么 都 不 做 ,因此 错误 处 理 代码 的 意义 不 大 。 下 面 来 扩展 这 个 示 
例 ， 看 看 在 你 使 用 多 个 文件 时 ， 异 常 处 理 可 提供 什么 样 的 帮助 。 


10.3.6 ”分析 文本 


你 可 以 分 析 包 含 整 本 书 的 文本 文件 。 很 多 经 典 文学 作品 都 是 以 简单 文本 文件 的 方式 提供 的 ， 
因为 它们 不 受 版 权限 制 。 本 节 使 用 的 文本 来 自 项 目 Gutenberg ( http://gutenberg.org/ )， 这 个 项 目 提 
供 了 一 系列 不 受 版 权限 制 的 文学 作品 , 如 果 你 要 在 编程 项 目 中 使 用 文学 文本 , 这 是 一 个 很 不 错 的 
资源 。 

下 面 来 提取 童话 4lice in Wonderlanq 的 文本 ， 并 尝试 计算 它 包 含 多 少 个 单词 。 我 们 将 使 用 方 
法 split(), 它 根据 一 个 字符 串 创建 一 个 单词 列表 。 下 面 是 对 只 包含 童话 名 "Alice in Wonderland" 
的 字符 串 调用 方法 split() 的 结 


>>> title = "Alice in Wonderland" 

>>> title.split() 

['Alice', 'in', 'Wonderland'] 

方法 split() 以 空格 为 分 隔 符 将 字符 串 分 拆 成 多 个 部 分 , 并 将 这 些 部 分 都 存储 到 一 个 列表 中 。 
结果 是 一 个 包含 字符 串 中 所 有 单词 的 列表 ， 虽 然 有 些 单词 可 能 包含 标点 。 为 计算 41ice in 
Wonderland 包 含 多 少 个 单词 ， 我 们 将 对 整 篇 小 说 调用 split()， 再 计算 得 到 的 列表 包含 多 少 个 元 
素 ， 从 而 确定 整 篇 童话 大 致 包含 多 少 个 单词 : 


filename 'alice.txt' 


try: 
with open(filename) as f obj: 
contents = f obj.read() 
except FileNotFoundError: 
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msg = "Sorry, the file " + filename + ”does not exist." 
print(msg) 
else: 
# 计算 文件 大 致 包含 多 少 个 单词 
© words = contents.split() 
(2 num words = len(words) 
(3 print("The file "+ filename + " has about "+ str(num words) + " words.") 


我 们 把 文件 alice.txt 移 到 了 正确 的 目录 中 ， 让 try 代 码 块 能 够 成 功 地 执行 。 在 @ 处 ， 我 们 对 变 
量 contents ( 它 现 在 是 一 个 长 长 的 字符 串 ， 包 含 童 话 4lice in Wonderland 的 全 部 文本 ) 调用 方法 
split()， 以 生成 一 个 列表 ， 其 中 包含 这 部 童话 中 的 所 有 单词 。 当 我 们 使 用 len() 来 确定 这 个 列表 
的 长 度 时 ， 就 知道 了 原始 字符 串 大致 包 含 多 少 个 单词 ( 见 @ )。 在 @ 处 ,我们 打印 一 条 消息 ， 指 
出 文件 包含 多 少 个 单词 。 这 些 代码 都 放 在 else 代 码 块 中 ， 因 为 仅 当 try 代 码 块 成 功 执行 时 才 执 行 
它们 。 输 出 指出 了 文件 alice.txt 包 含 多 少 个 单词 ; 


The file alice.txt has about 29461 words. 


这 个 数字 有 点 大 ， 因 为 这 里 使 用 的 文本 文件 包含 出 版 商 提供 的 额外 信息 ， 但 与 童话 41ice in 
Wonderland 的 长 度 相当 一 致 。 


10.3.7 ”使 用 多 个 文件 


下 面 多 分 析 几 本 书 。 ds 我 们 先 将 这 个 程序 的 大 部 分 代码 移 到 一 个 名 为 
count_words() 的 函数 中 ， 这 样 对 多 本 书 进行 分 析 时 将 更 容易 : 


word_count.py 


def count _words (filename): 
© "" 计 算 一 个 文件 大 致 包含 多 少 个 单词 """ 
try: 
with open(filename) as f obj: 
contents = f obj.read() 
except FileNotFoundError: 
msg = "Sorry, the file ”+ filename + " does not exist." 
print(msg) 
else: 
# 计算 文件 大 致 包含 多 少 个 单词 
words = contents.split() 
num words = len(words) 
print("The file "+ filename + " has about "+ str(num words) + 
" words.") 


filename = "alice.txt' 
count words(filename) 


这 些 代 码 大 都 与 原来 一 样 ， 我 们 只 是 将 它们 移 到 了 哨 数 count_words() 中 ， 并 增加 了 缩 进 量 。 
修改 程序 的 同时 更 新 注释 是 个 不 错 的 习惯 , 因此 我 们 将 注释 改 成 了 文档 字符 串 ， 并 稍微 调整 了 一 
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下 措辞 ( 见 @ )。 

现在 可 以 编写 一 个 简单 的 循环 ， 计 算 要 分 析 的 任何 文本 包含 多 少 个 单词 了 。 为 此 , 我 们 将 要 
分 析 的 文件 的 名 称 存储 在 一 个 列表 中 ， 然 后 对 列表 中 的 每 个 文件 都 调用 count_words()。 我 们 将 
尝试 计算 41ice in Wonderland、Siddhartha、Moby Dick 和 Little Women 分 别 包含 多 少 个 单词 ， 它 们 
都 不 受 版 权限 制 。 我 故意 没有 将 siddhartha.txt 放 到 word_count.py 所 在 的 目录 中 ， 让 你 能 够 看 到 这 
个 程序 在 文件 不 存在 时 处 理 得 有 多 出 色 : 


def count words(filename): 


-- Snip-- 


filenames = ['alice.txt', 'siddhartha.txt', "moby dick.txt', 'little women.txt'] 
for filename in filenames: 
count words (filename) 


文件 siddhartha.txt 不 存在 ， 但 这 丝毫 不 影响 这 个 程序 处 理 其 他 文件 : 


The file alice.txt has about 29461 words . 

Sorry, the file siddhartha.txt does not exist. 
The file moby dick.txt has about 215136 words. 
The file little women.txt has about 189079 words. 


在 这 个 示例 中 ， 使 用 try-except 代 码 块 提供 了 两 个 重要 的 优点 : 避免 让 用 户 看 到 traceback; 
让 程序 能 够 继续 分 析 能 够 找到 的 其 他 文件 。 如 果 不 捕获 因 找 不 到 siddhartha.txt 而 引发 的 
FileNotFoundError 异 常 ， 用 户 将 看 到 完整 的 traceback， 而 程序 将 在 尝试 分 析 Siddhartha 后 停止 运 
行 一 一 根本 不 分 析 Mopy Dick 和 Little Women。 


10.3.8 ”失败 时 一 声 不 咏 


在 前 一 个 示例 中 , 我 们 告诉 用 户 有 一 个 文件 找 不 到 。 但 并 非 每 次 捕获 到 异常 时 都 需要 告诉 用 
户 , 有 时候 你 希望 程序 在 发 生 异常 时 一 声 不 咏 ， 就 像 什么 都 没有 发 生 一 样 继续 运行 。 要 让 程序 在 
失败 时 一 声 不 咏 , 可 像 通常 那样 编写 try 代 码 块 , 但 在 except 代 码 块 中 明确 地 告诉 Python 什 么 都 不 
要 做 。Python 有 一 个 pass 语 句 ， 可 在 代码 块 中 使 用 它 来 让 Python 什么 都 不 要 做 : 


def count words(filename ) : 
"" "计算 一 个 文件 大 致 包含 多 少 个 单词 """ 
try: 
--Snip-- 
except FileNotFoundError: 
@ pass 
else: 
--Snip-- 


filenames = [ "alice.txt' ， 'siddhartha.txt', "moby dick.txt', 'little women.txt'] 
for filename in filenames: 
count words(filename) 
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相 比 于 前 一 个 程序 ， 这 个 程序 唯一 不 同 的 地 方 是 @ 处 的 pass 语 句 。 现 在 ， 出 现 
FileNotFoundError 异 常 时 , 将 执行 except 代 码 块 中 的 代码 , 但 什么 都 不 会 发 生 。 这 种 错误 发 生 时 ， 
不 会 出 现 traceback, 也 没有 任何 输出 。 用 户 将 看 到 存在 的 每 个 文件 包含 多 少 个 单词 , 但 没有 任何 
迹象 表明 有 一 个 文件 未 找到 : 

The file alice.txt has about 29461 words . 


The file moby dick.txt has about 215136 words. 
The file little women.txt has about 189079 words. 


pass 语 句 还 充当 了 占 位 符 , 它 提醒 你 在 程序 的 某 个 地 方 什么 都 没有 做 ,并 且 以 后 也 许 要 在 这 
里 做 些 什 么 。 例 如 ， 在 这 个 程序 中 ,我 们 可 能 决定 将 找 不 到 的 文件 的 名 称 写 入 到 文件 
missing_files.txt 中 。 用 户 看 不 到 这 个 文件 ， 但 我 们 可 以 读 取 这 个 文件 ， 进 而 处 理 所 有 文件 找 不 到 
的 问题 。 


10.3.9 决定 报告 哪些 错误 


在 什么 情况 下 该 向 用 户 报 告 错误 ?在 什么 情况 下 又 应 该 在 失败 时 一 声 不 蚁 呢 ?” 如 果 用 户 知 
道 要 分 析 哪 些 文件 ， 他 们 可 能 希望 在 有 文件 没有 分 析 时 出 现 一 条 消息 ， 将 其 中 的 原因 告诉 他 们 。 
如 果 用 户 只 想 看 到 结果 , 而 并 不 知道 要 分 析 哪 些 文件 , 可 能 就 无 需 在 有 些 文件 不 存在 时 告知 他 们 。 
向 用 户 显 示 他 不 想 看 到 的 信息 可 能 会 降低 程序 的 可 用 性 。Python 的 错误 处 理 结构 让 你 能 够 细致 地 
控制 与 用 户 分 享 错误 信息 的 程度 ， 要 分 享 多 少 信息 由 你 决定 。 
编写 得 很 好 且 经 过 详尽 测试 的 代码 不 容易 出 现 内 部 错误 , 如 语法 或 逻辑 错误 , 但 只 要 程序 依 
赖 于 外 部 因素 ， 如 用 户 输入 、 存 在 指定 的 文件 、 有 网 络 链接 ,就 有 可 能 出 现 异常 。 凭 借 经 验 可 判 
断 该 在 程序 的 什么 地 方 包含 异常 处 理 块 ， 以 及 出 现 错误 时 该 向 用 户 提 供 多 少 相关 的 信息 。 


动手 试 一 斌 

10-6 加 法 运算 : 提示 用 户 提供 数值 输入 时 ， 常 出 现 的 一 个 问题 是 ， 用 户 提供 的 是 

文本 而 不 是 数字 。 在 这 种 情况 下 ， 当 你 尝试 将 输入 转换 为 整数 时 ， 将 引发 TypeETTor 异 

常 。 编 写 一 个 程序 ,提示 用 户 输入 两 个 数字 ， 再 将 它们 相 加 并 打印 结果 。 在 用 户 输入 的 

任何 一 个 值 不 是 数字 时 都 捕获 TypeError 异常 ， 并 打印 一 条 友好 的 错误 消息 。 对 你 编写 
的 程序 进行 测试 : 先 输入 两 个 数字 ， 再 输入 一 些 文本 而 不 是 数字 。 


10-7 加 法 计算 器 : 将 你 为 完成 练习 10-6 而 编写 的 代码 放 在 一 个 while 循环 中 ， 让 
用 户 犯错 (输入 的 是 文本 而 不 是 数字 ) 后 能 够 继续 输入 数字 。 

10-8 猫 和 狗 : 创建 两 个 文件 cats.txt 和 dogs.txt， 在 第 一 个 文件 中 至 少 存储 三 只 猫 的 
名 字 ,， 在 第 二 个 文件 中 至 少 存储 三 条 狗 的 名 字 。 编 写 一 个 程序 ， 尝 试 读 取 这 些 文件 ， 并 
将 其 内 容 打 印 到 屏幕 上 。 将 这 些 代码 放 在 一 个 try-except 代码 块 中 ， 以 便 在 文件 不 存 
在 时 捕获 FileNotFound 错误 ， 并 打印 一 条 友好 的 消息 。 将 其 中 一 个 文件 移 到 另 一 个 地 
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方 ， 并 确认 except 代码 块 中 的 代码 将 正确 地 执行 。 

10-9 沉默 的 猫 和 狗 : 修改 你 在 练习 10-8 中 编写 的 except 代码 块 ， 让 程序 在 文件 不 
存在 时 一 言 不 发 。 

10-10 常见 单词 : 访问 项 目 Gutenberg ( http://gutenberg.org/ )， 并 找 一 些 你 想 分 析 的 
图 书 。 下 载 这 些 作品 的 文本 文件 或 将 浏览 器 中 的 原始 文本 复制 到 文本 文件 中 。 

你 可 以 使 用 方法 count() 来 确定 特定 的 单词 或 短语 在 字符 串 中 出 现 了 多 少 次 。 例 如 ， 
下 面 的 代码 计算 'row' 在 一 个 字符 囊 中 出 现 了 多 少 次 : 


>>> line = "Row, row, row your boat" 
>>> line.count('row') 

2 

>>> line.lower().count('row') 

引 


请 注意 ， 通 过 使 用 lower() 将 字符 串 转 换 为 小 写 ， 可 捕捉 要 查找 的 单词 出 现 的 所 有 
次 数 ， 而 不 管 其 大 小 写 格式 如 何 。 

编写 一 个 程序 ， 它 读 取 你 在 项 目 Gutenberg 中 获取 的 文件 ， 并 计算 单词 'the' 在 每 
个 文件 中 分 别 出 现 了 多 少 次 。 


10.4 存储 数据 


很 多 程序 都 要 求 用 户 输入 某 种 信息 , 如 让 用 户 存储 游戏 首选 项 或 提供 要 可 视 化 的 数据 。 不 管 
专注 的 是 什么 ,程序 都 把 用 户 提供 的 信息 存储 在 列表 和 字典 等 数据 结构 中 。 用 户 关闭 程序 时 ,你 
几乎 总 是 要 保存 他 们 提供 的 信息 ; 一 种 简单 的 方式 是 使 用 模块 json 来 存储 数据 。 

模块 json 让 你 能 够 将 简单 的 Python 数 据 结 构 转 储 到 文件 中 ， 并 在 程序 再 次 运行 时 加 载 该 文件 
中 的 数据 。 你 还 可 以 使 用 json 在 Python 程序 之 间 分 享 数 据 。 更 重要 的 是 ,JSON 数 据 格式 并 非 Python 
专用 的 ， 这 让 你 能 够 将 以 JSON 格 式 存 储 的 数据 与 使 用 其 他 编程 语言 的 人 分 享 。 这 是 一 种 轻便 格 
式 ， 很 有 用 ， 也 易于 学 习 。 


注意 JSON (JavaScript ObjectNotation ) 格式 最 初 是 为 JavaScript 开 发 的 ， 但 随后 成 了 一 种 常见 
格式 ， 被 包括 Python 在 内 的 众多 语言 采用 。 


10.4.1 使 用 json.dump() 和 json.1oad() 


我 们 来 编写 一 个 存储 一 组 数字 的 简短 程序 , 再 编写 一 个 将 这 些 数 字 读 取 到 内 存 中 的 程序 。 第 
一 个 程序 将 使 用 json.dump() 来 存储 这 组 数字 ， 而 第 二 个 程序 将 使 用 json.10ad()。 
函数 json.dump() 接 受 两 个 实 参 : 要 存储 的 数据 以 及 可 用 于 存储 数据 的 文件 对 象 。 下 面 演示 
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了 如 何 使 用 json.dump() 来 存储 数字 列表 : 


number_ writerpy 


import json 
numbers = [2，3，5，7，11，13] 
@ filename = numbers.json' 


@ with open(filename, 'w') as f obj: 
@ json.dump(numbers, f_obj) 


我 们 先导 入 模块 json， 再 创建 一 个 数字 列表 。 在 @ 处 ， 我 们 指定 了 要 将 该 数字 列表 存储 到 其 
中 的 文件 的 名 称 。 通 常 使 用 文件 扩展 名 .json 来 指出 文件 存储 的 数据 为 JSON 格 式 。 接 下 来 ， 我 们 
以 写 和 模式 打开 这 个 文件 ,让 json 能 够 将 数据 写 入 其 中 ( 见 @ ), 在 @ 处 ,我 们 使 用 函数 json.dump() 
将 数字 列表 存储 到 文件 numbers.json 中 。 

这 个 程序 没有 输出 ， 但 我 们 可 以 打开 文件 numbers.json， 看 看 其 内 容 。 数 据 的 存储 格式 与 
Python 中 一 样 : 


[2，3，5，7，11，13] 


下 面 再 编写 一 个 程序 ， 使 用 json.1load() 将 这 个 列表 读 取 到 内 存 中 


number_reader.py 


mport json 
@ filename = 'numbers.json’ 
@ with open(filename) as f_obj: 
9 numbers = json.load(f obj) 


print(numbers) 


在 @ 处 , 我 们 确保 读 取 的 是 前 面 写 入 的 文件 ,。 这 次 我 们 以 读 取 方式 打开 这 个 文件 , 因为 Python 
只 需 读 取 这 个 文件 ( 见 @ ), 在 @ 处 , 我 们 使 用 函数 json.1oad() 加 载 存储 在 numbers.json 中 的 信息 ， 
并 将 其 存储 到 变量 numpers 中 。 最 后 ， 我 们 打印 恢复 的 数字 列表 ， 看 看 它 是 否 与 namber_ writerpy 
中 创建 的 数字 列表 相同 : 


[223753 37) T1513 
这 是 一 种 在 程序 之 间 共 享 数据 的 简单 方式 。 
10.4.2 ”保存 和 读 取 用 户 生成 的 数据 


对 于 用 户 生成 的 数据 ,使 用 json 保 存 它们 大 有 神 益 ， 因 为 如 果 不 以 某 种 方式 进行 存储 ， 等 程 
序 停止 运行 时 用 户 的 信息 将 丢失 。 下 面 来 看 一 个 这 样 的 例子 : 用 户 首次 运行 程序 时 被 提示 输入 自 
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己 的 名 字 ， 这 样 再 次 运行 程序 时 就 记 住 他 了 。 
我 们 先 来 存储 用 户 的 名 字 : 


remember_me.py 


import json 
@ username = input("What is your name? ") 


filename = "username.json’ 
with open(filename, 'w') as f obj: 
@ json.dump(username, f_obj) 
@ print("We'll remember you when you come back, " + username + "!") 


在 @ 处 ,我 们 提示 输入 用 户 名 ， 并 将 其 存储 在 一 个 变量 中 。 接 下 来 ,我 们 调用 json. dump()， 
并 将 用 户 名 和 一 个 文件 对 象 传递 给 它 ， 从 而 将 用 户 名 存储 到 文件 中 ( 见 @ )。 然 后 ， 我 们 打印 一 
条 消息 ， 指 出 我 们 存储 了 他 输入 的 信息 ( 见 @ ): 


What is your name? Eric 
We'll remember you when you come back, Eric! 


现在 再 编写 一 个 程序 ， 向 其 名 字 被 存储 的 用 户 发 出 问候 : 


greet user.py 


import json 
filename = "username.json’ 
with open(filename) as f obj: 


© username = json.1load(f_obj) 
@ print("Welcome back, " + username + "1") 


在 @ 处 ， 我 们 使 用 json.1oad() 将 存储 在 username.json 中 的 信息 读 取 到 变量 username 中 。 恢 复 
用 户 名 后 ， 我 们 就 可 以 欢迎 用 户 回来 了 ( 见 @ ): 


Welcome back, Eric! 


我 们 需要 将 这 两 个 程序 合并 到 一 个 程序 (remember me.py ) 中 。 这 个 程序 运行 时 ,我们 将 尝 
试 从 文件 usemame.json 中 获取 用 户 名 ， 因 此 我 们 首先 编写 一 个 尝试 恢复 用 户 名 的 try 代 码 块 。 如 
果 这 个 文件 不 存在 ,我们 就 在 except 代 码 块 中 提示 用 户 输入 用 户 名 ， 并 将 其 存储 在 username.json 
中 ， 以 便 程序 再 次 运行 时 能 够 获取 它 : 


remember_me.py 


import json 


# 如 果 以 前 存储 了 用 户 名 ， 就 加 载 它 
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# 否则， 就 提示 用 户 输入 用 户 名 并 存储 它 
filename = “USsername.json 


try: 
with open 


filename) as f_ obj: 


username = json.1o0ad(f _ obj) 


tFoundError: 


username = input("What is your name? ") 


© 
2 
©@ except FileNo 
@ 
© 


with open 


filename, 'w') as f obj: 


json.dump(username, f_obj) 


print 
else: 
print("We 


"We'll remember you when you come back, " + username + "!") 


come back, " + username + "!") 


这 里 没有 任何 新 代码 ， 只 是 将 前 两 个 示例 的 代码 合并 到 了 一 个 程序 中 。 在 @ 人 处 ， 我们 尝试 打 
son。 如 果 这 个 文件 存在 ,就 将 其 中 的 用 户 名 读 取 到 内 存 中 ( 见 @ ), 再 执行 else 
代码 块 , 即 打印 一 条 欢迎 用 户 回来 的 消息 。 用 户 首次 运行 这 个 程序 时 , 文件 username.json 不 存在 ， 
将 引发 FileNotFoundError 异 常 ( 见 @ ), 因此 Python 将 执行 except 代 码 块 : 提示 用 户 输入 其 用 户 名 


开 文 件 usernamejj 


( 见 @ )， 再 使 用 j 


son.dump() 存 储 该 用 户 名 ， 并 打印 一 名 问候 语 ( 见 @ )。 


无 论 执行 的 是 except 代 码 块 还 是 else 代 码 块 ， 都 将 显示 用 户 名 和 合适 的 问候 语 。 如 果 这 个 程 
序 是 首次 运行 ， 输 出 将 如 下 : 


What is your name? Eric 
We'll remember you when you come back, Eric! 


否则 ， 输 出 将 如 下 : 


Welcome back, 


县 Ci 


这 是 程序 之 前 至 少 运 行 了 一 次 时 的 输出 。 


10.4.3” 重 构 


你 经 常会 遇 到 这 样 的 情况 : 代码 能 够 正确 地 运行 ， 但 可 做 进一步 的 改进 一 一 将 代码 划分 为 
一 系列 完成 具体 工作 的 函数 。 这 样 的 过 程 被 称 为 重 构 。 重 构 让 代码 更 清晰 、 更 易于 理解 、 更 容 


易 扩展 。 


要 重 构 remember me.py, 可 将 其 大 部 分 逻辑 放 到 一 个 或 多 个 函数 中 。remember me.py 的 重点 


是 问候 用 户 ， 因 此 我 们 将 其 所 有 代码 都 放 到 一 个 名 为 greet_user() 的 函数 中 


remember_me.py 


import Json 


def greet user(): 
© "" "问候 用 户 ， 并 指出 其 名 字 """ 


filename 
try: 


'Username.json’ 
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with open(filename) as f obj: 
username = json.load(f obj) 
except FileNotFoundError: 
username = input("What is your name? ") 
with open(filename, 'w') as f obj: 
json.dump(username, f obj) 
print("We'll remember you when you come back, " + username + "!") 
else: 
print("Welcome back, " + username + "!") 


greet user() 


考虑 到 现在 使 用 了 一 个 函数 , 我 们 删除 了 注释 , 转 而 使 用 一 个 文档 字符 串 来 指出 程序 是 做 什 
么 的 ( 见 @ ),。 这 个 程序 更 清晰 些 , 但 函数 greet_user() 所 做 的 不 仅仅 是 问候 用 户 , 还 在 存储 了 用 
户 名 时 获取 它 ， 而 在 没有 存储 用 户 名 时 提示 用 户 输入 一 个 。 

下 面 来 重 构 greet_user()， 让 它 不 执行 这 么 多 任务 。 为 此 ， 我 们 首先 将 获取 存储 的 用 户 名 的 
代码 移 到 男 一 个 函数 中 : 


import json 


def get stored username(): 
© "" "如果 存储 了 用 户 名 ， 就 获取 它 """ 
filename = 'username.json’ 
try: 
with open(filename) as f obj: 
username = json.load(f obj) 
except FileNotFoundError: 
@ return None 
else: 
return username 


def greet user(): 
""" 间 候 用 户 ， 并 指出 其 名 字 """ 
username = get stored username() 


@ if username: 
print("Welcome back, " + username + "!") 
else: 
username = input("What is your name? ") 
filename = 'username.json’ 


with open(filename, 'w') as f obj: 
json.dump(username, f obj ) 
print("We'll remember you when you come back, " + username + "!") 


greet user() 


新 增 的 函数 get_stored_username() 目 标明 确 ，@ 处 的 文档 字符 串 指出 了 这 一 点 。 如 果 存 储 了 
用 户 名 , 这 个 函数 就 获取 并 返回 它 ; 如 果 文 件 username.json 不 存在 , 这 个 函数 就 返回 None ( 见 @ )。 
这 是 一 种 不 错 的 做 法 : 函数 要 么 返回 预期 的 值 ， 要 么 返回 None; 这 让 我 们 能 够 使 用 函数 的 返回 值 
做 简单 测试 。 在 @ 处 ， 如 果 成 功 地 获取 了 用 户 名 ,就 打印 一 条 欢迎 用 户 回 来 的 消息 ， 否 则 就 提示 
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用 户 输入 用 户 名 。 
我 们 还 需 将 greet_user() 中 的 另 一 个 代码 块 提取 出 来 : 将 没有 存储 用 户 名 时 提示 用 户 输入 的 
代码 放 在 一 个 独立 的 函数 中 : 


import json 
def get stored username() 
""" 如 果 存 储 了 用 户 名 ， 就 获取 它 """ 


-- Snip-- 


def get new username(): 


wun 提示 用 户 输入 用 户 名 """ 
username = input("What is your name? ") 
filename = 'Uusername.json’ 


with open(filename, 'w') as f obj: 
json.dump(username, f obj) 
return username 


def 


greet user(): 

"" "问候 用 户 ， 并 指出 其 名 字 """ 
username = get stored username() 
if username: 


print("Welcome back, " + username + "!") 
else: 
username = get new username() 
print("We'll remember you When you come back, " + username + "!") 


greet user() 


在 remember me.py 的 这 个 最 终 版 本 中 ， 每 个 函数 都 执行 单一 而 清晰 的 任务 。 我 们 调用 
greet_user() ， 它 打印 一 条 合适 的 消息 : 要 么 欢迎 老 用 户 回来 ,要么 问候 新 用 户 。 为 此 ， 它 首先 
调用 get_stored_username() ， 这 个 函数 只 负责 获取 存储 的 用 户 名 〈 如 果 存 储 了 的 话 )， 再 在 必要 
时 调用 get_new_username() ， 这 个 函数 只 负责 获取 并 存储 新 用 户 的 用 户 名 。 要 编写 出 清晰 而 易于 
维护 和 扩展 的 代码 ， 这 种 划分 工作 必 不 可 少 。 


动手 试 一 斌 
10-11 喜欢 的 数字 : 编写 一 个 程序 ， 提 示 用 户 输 入 他 喜欢 的 数字 ， 并 使 用 
json.dump() 将 这 个 数字 存储 到 文件 中 。 再 编写 一 个 程序 ,从 文件 中 读 取 这 个 值 ， 并 打 


?9 


印 消息 “I know your favorite number! It’s 2 


10-12 记 住 喜欢 的 数字 : 将 练习 10-11 中 的 两 个 程序 合 而 为 一 。 如 果 存 储 了 用 户 喜 
欢 的 数字 ,就 向 用 户 显示 它 ， 否则 提示 用 户 输入 他 喜欢 的 数字 并 将 其 存储 到 文件 中 。 运 
行 这 个 程序 两 次 ， 看 看 它 是 否 像 预期 的 那样 工作 。 

10-13 验证 用 户 : 最 后 一 个 remember me.py 版 本 假设 用 户 要 么 已 输入 其 用 户 名 , 要 
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么 是 首次 运行 该 程序 。 我 们 应 修改 这 个 程序 ， 以 应 对 这 样 的 情形 : 当前 和 最 后 一 次 运行 
该 程序 的 用 户 并 非 同 一 个 人 。 

为 此 ,在 greet user() 中 打印 欢迎 用 户 回 来 的 消息 前 , 先 询 问 他 用 户 名 是 否 是 对 的 。 
如 果 不 对 ， 就 调用 get new username() 让 用 户 输入 正确 的 用 户 名 。 


10.5 ”小结 


在 本 章 中 ,你 学 习 了 : 如 何 使 用 文件 ; 如 何 一 次 性 读 取 整个 文件 ， 以 及 如 何以 每 次 一 行 的 方 
式 读 取 文件 的 内 容 ; 如 何 写 入 文件 ,以 及 如 何 将 文本 附加 到 文件 末尾 ; 什么 是 异常 以 及 如 何 处 理 
程序 可 能 引发 的 异常 ; 如 何 存储 Python 数 据 结 构 ， 以 保存 用 户 提供 的 信息 ， 避 免 用 户 每 次 运行 程 
序 时 都 需要 重新 提供 。 

在 第 11 章 中 ,你 将 学 习 高 效 的 代码 测试 方式 ,这 可 帮助 你 确定 代码 正确 无 误 ， 以 及 发 现 扩展 
现 有 程序 时 可 能 引入 的 bug。 


测试 代码 


编写 函数 或 类 时 ， 还 可 为 其 编写 测试 。 通 过 测试 ， 可 确定 代码 
面 对 各 种 输入 都 能 够 按 要 求 的 那样 工作 。 测 试 让 你 信心 满 满 ， 深 信 
即便 有 更 多 的 人 使 用 你 的 程序 ， 它 也 能 正确 地 工作 。 在 程序 中 添加 
新 代码 时 ， 你 也 可 以 对 其 进行 测试 ， 确 认 它 们 不 会 破坏 程序 既 有 的 
行为 。 程 序 员 都 会 犯错 ， 因 此 每 个 程序 员 都 必须 经 常 测试 其 代码 ， 
在 用 户 发 现 问题 前 找 出 它们 。 

在 本 章 中 ,你 将 学 习 如 何 使 用 Python 模 块 unittest 中 的 工具 来 测 
试 代码 。 你 将 学 习 编 写 测 试用 例 ， 核 实 一 系列 输入 都 将 得 到 预期 的 
输出 。 你 将 看 到 测试 通过 了 是 什么 样子 , 测试 未 通过 又 是 什么 样子 ， 
还 将 知道 测试 未 通过 如 何 有 助 于 改进 代码 。 你 将 学 习 如 何 测试 函数 和 类 ， 并 将 知道 该 为 项 
目 编写 多 少 个 测试 。 


11.1 测试 函数 


要 学 习 测 试 , 得 有 要 测试 的 代码 。 下 面 是 一 个 简单 的 函数 , 它 接受 名 和 姓 并 返回 整洁 的 姓名 


name_function.py 


def get formatted name(first, last): 
"""Generate a neatly formatted full name.""" 
full name = first + ' ' + last 
return full name.title() 


函数 get_formatted_name() 将 名 和 姓 合 并 成 姓名 ， 在 名 和 姓 之 间 加 上 一 个 空格 ， 并 将 它们 的 
首 字 母 都 大 写 ， 再 返回 结果 。 为 核实 get_ formatted_name() 像 期 望 的 那样 工作 ， 我 们 来 编写 一 个 
使 用 这 个 函数 的 程序 。 程 序 names.py 让 用 户 输入 名 和 姓 ， 并 显示 整洁 的 全 名 : 


names.py 


from name function import get formatted name 
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print("Enter 'q' at any time to quit.") 
while True: 
first = input("\nplease give me a first name: ") 
if "first = “0 
break 
last = input("Please give me a last name: ") 
if last == 'q': 
break 
formatted name = get formatted name(first, last) 


print("\tNeatly formatted name: " + formatted name + '.') 


这 个 程序 从 name function.py 中 导 和 人 get formatted name()。 用 户 可 输入 一 系列 的 名 和 姓 ， 并 
看 到 格式 整洁 的 全 名 : 


Enter 'q' at any time to quit. 


局 


lease give me a first name: janis 
lease give me a last name: joplin 
Neatly formatted name: Janis Joplin. 


D 


口 


lease give me a first name: bob 
lease give me a last name: dylan 
Neatly formatted name: Bob Dylan. 


口 


Please give me a first name: q 


从 上 述 输出 可 知 ， 合 并 得 到 的 姓名 正确 无 误 。 现 在 假设 我 们 要 修改 get_formatted_name()， 
使 其 还 能 够 处 理 中 间 名 。 这 样 做 时 ， 我 们 要 确保 不 破坏 这 个 函数 处 理 只 有 名 和 姓 的 姓名 的 方式 。 
为 此 ， 我 们 可 以 在 每 次 修改 get_formatted_name() 后 都 进行 测试 : 运行 程序 names.py， 并 输入 像 
Janis Joplin 这 样 的 姓名 , 但 这 太 烦 珊 了 。 所 垃 Python 提 供 了 一 种 自动 测试 函数 输出 的 高 效 方式 。 
倘若 我 们 对 get_formatted_name() 进 行 自 动 测 试 ， 就 能 始终 信心 满 满 ， 确 信 给 这 个 函数 提供 我 们 
测试 过 的 姓名 时 ， 它 都 能 正确 地 工作 。 

11.1.1 单元 测试 和 测试 用 例 

Python 标准 库 中 的 模块 unittest 提 供 了 代码 测试 工具 。 单 元 测试 用 于 核实 函数 的 某 个 方面 没 
有 问题 ;测试 用 例 是 一 组 单元 测试 , 这 些 单元 测试 一 起 核实 函数 在 各 种 情形 下 的 行为 都 符合 要 求 。 
良好 的 测试 用 例 考虑 到 了 函数 可 能 收 到 的 各 种 输入 , 包含 针对 所 有 这 些 情形 的 测试 。 全 和 覆盖 式 测 
试用 例 包含 一 整套 单元 测试 , 涵盖 了 各 种 可 能 的 函数 使 用 方式 。 对 于 大 型 项 目 , 要 实现 全 和 获 盖 可 
能 很 难 。 通常 , 最 初 只 要 针对 代码 的 重要 行为 编写 测试 即 可 , 等 项 目 被 广泛 使 用 时 再 考虑 全 覆盖 。 
11.1.2 ”可 通过 的 测试 


创建 测试 用 例 的 语法 需要 一 段 时 间 才 能 习惯 , 但 测试 用 例 创 建 后 , 再 添加 针对 函数 的 单元 测 
试 就 很 简单 了 。 要 为 函数 编写 测试 用 例 ， 可 先导 入 模块 unittest 以 及 要 测试 的 函数 ， 表 创建 一 个 
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继承 unittest.TestCase 的 类 ， 并 编写 一 系列 方法 对 函数 行为 的 不 同方 面 进行 测试 。 
下 面 是 一 个 只 包含 一 个 方法 的 测试 用 例 ， 它 检查 函数 get_formatted_name() 在 给 定名 和 姓 时 
能 否 正确 地 工作 : 


test_name_ function.py 


import unittest 

from name function import get formatted name 

@ class NamesTestCase(unittest.TestCase) 
”测试 name_function.py”” 


def test first last name(self): 
""" 能 够 正确 地 处 理 像 Janis Joplin 这 样 的 姓名 吗 ?》""" 
© formatted name = get formatted name('janis', 'joplin') 
(3 self.assertEqual(formatted name, 'Janis Joplin') 


unittest.main() 


首先 ,我们 导入 了 模块 unittest 和 要 测试 的 函数 get_formatted” name()。 在 @ 处 ,我 们 创建 
了 一 个 名 为 NamesTestCase 的 类 ， 用 于 包含 一 系列 针对 get_formatted_name() 的 单元 测试 。 你 可 随 
便 给 这 个 类 命名 ,但 最 好 让 它 看 起 来 与 要 测试 的 函数 相关 ， 并 包含 字样 Test。 这 个 类 必须 继承 
unittest.TestCase 类 ， 这 样 Python 才 知道 如 何 运行 你 编写 的 测试 。 

NamesTestCase 只 包含 一 个 方法 ， 用 于 测试 get_formatted_name() 的 一 个 方面 。 我 们 将 这 个 方 
法 命名 为 test_first_last_name(), 因为 我 们 要 核实 的 是 只 有 名 和 姓 的 姓名 能 否 被 正确 地 格式 化 。 
我 们 运行 test_name_function.py 时 ,所 有 以 test 打头 的 方法 都 将 自动 运行 。 在 这 个 方法 中 ,我 们 
调用 了 要 测试 的 函数 ,并 存储 了 要 测试 的 返回 值 ,在 这 个 示例 中 ,我 们 使 用 实 参 'janis' 和 'joplin' 
调用 get_formatted_name()， 并 将 结果 存储 到 变量 formatted _name 中 ( 见 @ )。 

在 人 @ 处 ,我 们 使 用 了 unittest 类 最 有 用 的 功能 之 一 : 一 个 断言 方法 。 断 言 方法 用 来 核实 得 到 
的 结果 是 和 否 与 期 望 的 结果 一 致 。 在 这 里 ， 我 们 知道 get formatted_name() 应 返回 这 样 的 姓名 ， 即 
名 和 姓 的 首 字 母 为 大 写 ， 且 它们 之 间 有 一 个 空格 ， 因 此 我 们 期 望 formatted_name 的 值 为 Janis 
Joplin。 为 检查 是 否 确实 如 此 ， 我 们 调用 unittest 的 方法 assertEqual()， 并 向 它 传递 formatted_ 
name 和 'Janis Joplin' 。 代 码 行 self.assertEqual(formatted name，']Janis Joplin') 的 意思 是 说 : 
“将 formatted_name 的 值 同 字 符 串 'Janis Joplin' 进 行 比较 ， 如 果 它 们 相等 ， 就 万 事 大 吉 ， 如 果 它 
们 不 相等 ， 跟 我 说 一 声 !1” 

代码 行 unittest.main() 让 Python 运 行 这 个 文件 中 的 测试 。 运 行 test_name function.py 时 ， 得 
到 的 输出 如 下 : 


Ran 1 test in 0.000s 


OK 
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第 1 行 的 句点 表明 有 一 个 测试 通过 了 。 接 下 来 的 一 行 指 出 Python 运 行 了 一 个 测试 ， 消 耗 的 时 
间 不 到 0.001 秒 。 最 后 的 OK 表明 该 测试 用 例 中 的 所 有 单元 测试 都 通过 了 。 

上 述 输 出 表明 ， 给 定 包含 名 和 姓 的 姓名 时 ， 函 数 get_formatted_name() 总 是 能 正确 地 处 理 。 
修改 get_formatted_name() 后 , 可 再 次 运行 这 个 测试 用 例 。 如 果 它 通过 了 ,我 们 就 知道 在 给 定 ]anis 
]oplin 这 样 的 姓名 时 ， 这 个 函数 依然 能 够 正确 地 处 理 。 


11.1.3 不 能 通过 的 测试 


测试 未 通过 时 结果 是 什么 样 的 呢 ?” 我 们 来 修改 get_formatted_name(), 使 其 能 够 处 理 中 间 名 ， 
但 这 样 做 时 ， 故 意 让 这 个 函数 无 法 正确 地 处 理 像 Janis Joplin 这 样 只 有 名 和 姓 的 姓名 。 
下 面 是 函数 get_ formatted_name() 的 新 版 本 ， 它 要 求 通过 一 个 实 参 指 定 中 间 名 : 


name_ function.py 


def get formatted name(first, middle, last): 
Wm 生成 整洁 的 如 名 
full name = first + ' ' + middle + ” ' + last 
return full name.title() 


这 个 版 本 应 该 能 够 正确 地 处 理 包含 中 间 名 的 姓名 , 但 对 其 进行 测试 时 , 我 们 发 现 它 再 也 不 能 
正确 地 处 理 只 有 名 和 姓 的 姓名 。 这 次 运行 程序 test_name_function.py 时 ， 输 出 如 下 : 


四 Traceback (most recent Call last): 
File "test name function.py", line 8, in test first last name 
formatted name = get formatted name('janis', 'joplin') 
TypeError: get formatted name() missing 1 required positional argument: "last' 


@ Ran 1 test in 0.000s 


@ FAILED (errors=1) 


其 中 包含 的 信息 很 多 ， 因 为 测试 未 通过 时 ， 需 要 让 你 知道 的 事情 可 能 有 很 多 。 第 1 行 输出 只 
有 一 个 字母 E( 见 @@)， 它 指出 测试 用 例 中 有 一 个 单元 测试 导致 了 错误 。 接 下 来 ， 我 们 看 到 
NamesTestCase 中 的 test first last_name() 导 致 了 错误 ( 见 @ ), 测试 用 例 包含 众多 单元 测试 时 ， 
知道 哪个 测试 未 通过 至 关 重 要 。 在 @ 处 ,我 们 看 到 了 一 个 标准 的 traceback ， 它 指出 函数 调用 
get_formatted_name('janis'，'joplin') 有 问题 ， 因 为 它 缺 少 一 个 必 不 可 少 的 位 置 实 参 。 

我 们 还 看 到 运行 了 一 个 单元 测试 ( 见 @ )。 最 后 ， 还 看 到 了 一 条 消息 ， 它 指出 整个 测试 用 例 
都 未 通过 ， 因 为 运行 该 测试 用 例 时 发 生 了 一 个 错误 ( 见 @ )。 这 条 消息 位 于 输出 末尾 ， 让 你 一 眼 
就 能 看 到 一 一 你 可 不 希望 为 获悉 有 多 少 测试 未 通过 而 翻阅 长 长 的 输出 。 
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11.1.4 测试 未 通过 时 怎么 办 


测试 未 通过 时 怎么 办 呢 ? 如 果 你 检查 的 条 件 没 错 , 测试 通过 了 意味 着 函数 的 行为 是 对 的 ,而 
测试 未 通过 意味 着 你 编写 的 新 代码 有 错 。 因 此 , 测试 未 通过 时 ,不 要 修改 测试 ， 而 应 修复 导致 测 
试 不 能 通过 的 代码 : 检查 刚 对 函数 所 做 的 修改 ， 找 出 导致 函数 行为 不 符合 预期 的 修改 。 

在 这 个 示例 中 ，get_formatted_name() 以 前 只 需要 两 个 实 参 名 和 姓 ， 但 现在 它 要 求 提供 
名 、 中 间 名 和 姓 。 新 增 的 中 间 名 参数 是 必 不 可 少 的 ， 这 导致 get_formatted_name() 的 行为 不 符合 
预期 。 就 这 里 而 言 ， 最 佳 的 选择 是 让 中 间 名 变 为 可 选 的 。 这 样 做 后 ， 使 用 类 似 于 Janis Joplin 的 姓 
名 进行 测试 时 ， 测试 就 会 通过 了 ， 同 时 这 个 函数 还 能 接受 中 间 名 。 下 面 来 修改 
get_formatted_name() ， 将 中 间 名 设置 为 可 选 的 ， 然 后 再 次 运行 这 个 测试 用 例 。 如 果 通 过 了 ,我 
们 接着 确认 这 个 也 数 能 够 妥善 地 处 理 中 间 名 。 

要 将 中 间 名 设置 为 可 选 的 , 可 在 函数 定义 中 将 形 参 middle 移 到 形 参 列表 末尾 ， 并 将 其 默认 值 
间 定 为 一 个 空 字 符 串 。 我 们 还 要 添加 一 个 if 测试 ， 以 便 根据 是 否 提 供 了 中 间 名 相应 地 创建 姓名 : 


name_function.py 


def get formatted name(first, last, middle="'): 


if middle: 


full name = first + ' ' +middle + ' ' + last 
else: 


full name = first + ' ' + last 


在 get formatted name() 的 这 个 新 版 本 中 ， 中 间 名 是 可 选 的 。 如 果 向 这 个 函数 传递 了 中 间 名 
(if middle: )， 姓 名 将 包含 名 、 中 间 名 和 姓 ， 否 则 姓名 将 只 包含 名 和 姓 。 现 在 ， 对 于 两 种 不 同 的 
姓名 ， 这 个 函数 都 应 该 能 够 正确 地 处 理 。 为 确定 这 个 函数 依然 能 够 正确 地 处 理 像 Janis Joplin 这 样 
的 姓名 ， 我 们 再 次 运行 test_name_function.py: 


Ran 1 test in 0.000s 


OK 


现在 ， 测 试用 例 通 过 了 。 太 好 了 ， 这 意味 着 这 个 函数 又 能 正确 地 处 理 像 Janis Joplin 这 样 的 姓 
名 了 ,而 且 我 们 无 需 手工 测试 这 个 函数 。 这 个 函数 很 容易 就 修复 了 ,因为 未 通过 的 测试 让 我 们 得 
知 新 代码 破坏 了 函数 原来 的 行为 。 


11.1.5 ”添加 新 测试 


确定 get_formatted_name() 又 能 正确 地 处 理 简 单 的 姓名 后 ， 我 们 再 编写 一 个 测试 ， 用 于 测试 
包含 中 间 名 的 姓名 。 为 此 ， 我 们 在 NamesTestCase 类 中 再 添加 一 个 方法 : 
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import unittest 


from name function import get formatted name 


class NamesTestCase(unittest.TestCase): 
“测试 name function.py """ 


def test first last name(self) 


""" 能 够 正确 地 处 理 像 Janis Joplin 这 样 的 姓名 吗 ?》""" 
ormatted name = get formatted name('janis', 'joplin') 
self.assertEqual(formatted name, 'Janis Joplin') 


def test first last middle name(self): 
""" 能 够 正确 地 处 理 像 Nolfgang Amadeus Mozart 这 样 的 姓名 吗 ?》""" 
© formatted name = get formatted name( 
'wolfgang', 'mozart', 'amadeus') 
self.assertEqual(formatted name, 'Wolfgang Amadeus Mozart') 


unittest.main() 


我 们 将 这 个 方法 命名 为 test first last middle name()。 方法 名 必须 以 test_ 打头， 这样 它 才 
会 在 我 们 运行 test_name_function.py 时 自动 运行 。 这 个 方法 名 清楚 地 指出 了 它 测试 的 是 get_ 
formatted_name() 的 哪个 行为 ， 这 样 ， 如 果 该 测试 未 通过 ， 我 们 就 会 马上 知道 受 影响 的 是 哪 种 类 
型 的 姓名 。 在 TestCase 类 中 使 用 很 长 的 方法 名 是 可 以 的 ; 这 些 方法 的 名 称 必 须 是 描述 性 的 ， 这 才 
能 让 你 明白 测试 未 通过 时 的 输出 ; 这 些 方法 由 Python 自动 调用 , 你 根本 不 用 编写 调用 它们 的 代码 。 

为 测试 函数 get_formatted_name() ， 我 们 使 用 名 、 姓 和 中 间 名 调用 它 ( 见 @ )， 再 使 用 
assertEqual() 检 查 返 回 的 姓名 是 否 与 预期 的 姓名 ( 名 、 中 间 名 和 姓 ) 一 致 。 我 们 再 次 运行 
test_name function.py 时 ， 两 个 测试 都 通过 了 : 


Ran 2 tests in 0.000s 


OK 


太 好 了 ! 现在 我 们 知道 ， 这 个 函数 又 能 正确 地 处 理 像 Janis Joplin 这 样 的 姓名 了 ， 我 们 还 深信 
它 也 能 够 正确 地 处 理 像 Wolfgang Amadeus Mozart 这 样 的 姓名 。 


动手 试 一 试 
11-1 城 市 和 国家 : 编写 一 个 函数 ， 它 接受 两 个 形 参 : 一 个 城市 名 和 一 个 国家 名 。 这 
个 函数 返回 一 个 格式 为 City, Country 的 字符 串 ， 如 Santiago, Chile。 将 这 个 函数 存储 


在 一 个 名 为 city functions.py 的 模块 中 。 
创建 一 个 名 为 test_cities.py 的 程序 ， 对 刚 编写 的 函数 进行 测试 ( 别 忘 了 ,你 需要 导 
入 模块 unittest 以 及 要 测试 的 函数 ), 编写 一 个 名 为 test city country() 的 方法 , 核实 
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使 用 类 似 于 'santiago' 和 'chile' 这 样 的 值 来 调用 前 述 函数 时 ， 得 到 的 字符 串 是 正确 的 。 
运行 test _ cities.py， 确 认 测 试 test_city country() 通 过 了 。 

11-2 人 口 数量 : 修改 前 面 的 函数 , 使 其 包含 第 三 个 必 不 可 少 的 形 参 population， 并 
返回 一 个 格式 为 City，Country - population xxx 的 字符 串 ， 如 Santiago，Chile - 
population 5000000。 运 行 test_cities.py， 确 认 测 试 test_city country() 未 通过 。 

修改 上 述 函 数 ， 将 形 参 population 设置 为 可 选 的 。 再 次 运行 test_cities.py， 确 认 测 
试 test city country() 又 通过 了 。 

再 编写 一 个 名 为 test city country population() 的 测试 ， 核 实 可 以 使 用 类 似 于 
'santiago' 、'chile' 和 'population=5000000' 这样 的 值 来 调用 这 个 函数 。 再 次 运行 
test_cities.py， 确 认 测 试 test_city country population() 通 过 了 。 


11.2 ”测试 类 


在 本 章 前 半 部 分 , 你 编号 了 针对 单个 函数 的 测试 ,下面 来 编写 针对 类 的 测试 。 很 多 程序 中 都 
会 用 到 类 ， 因 此 能 够 证 明 你 的 类 能 够 正确 地 工作 会 大 有 神 益 。 如 果 针 对 类 的 测试 通过 了 , 你 就 能 
确信 对 类 所 做 的 改进 没有 意外 地 破坏 其 原 有 的 行为 。 


11.2.1 各 种 断言 方法 


Python 在 unittest.TestCase 类 中 提供 了 很 多 断言 方法 。 前 面 说 过 ， 断 言 方 法 检查 你 认为 应 
该 满足 的 条 件 是 否 确实 满足 。 如 果 该 条 件 确实 满足 ， 你 对 程序 行为 的 假设 就 得 到 了 确认 ， 你 就 可 
以 确信 其 中 没有 错误 。 如 果 你 认为 应 该 满足 的 条 件 实际 上 并 不 满足 ，Python 将 引发 异常 。 

表 11-1 描 述 了 6 个 常用 的 断言 方法 。 使 用 这 些 方法 可 核实 返回 的 值 等 于 或 不 等 于 预期 的 值 、 
返回 的 值 为 True 或 False、 返 回 的 值 在 列表 中 或 不 在 列表 中 。 你 只 能 在 继承 unittest.TestCase 的 
类 中 使 用 这 些 方法 ， 下 面 来 看 看 如 何在 测试 类 时 使 用 其 中 的 一 个 。 


表 11-1 unittest Module 中 的 断言 方法 


方 法 用 途 
assertEqual(a, b) 核实 a == b 
assertNotEqual(a, b) 核实 a != b 
assertTrue(x) 核实 x 为 True 
assertFalse(x) 核实 x 为 False 
assertIn(item, 71ist) 核实 iten 太 7ist 中 
assertNotIn( item, 7ist) 核实 iten 不 在 7ist 中 


194 第 11 章 测试 代码 


11.2.2 ”一 个 要 测试 的 类 


类 的 测试 与 函数 的 测试 相似 一 一 你 所 做 的 大 部 分 工作 都 是 测试 类 中 方法 的 行为 , 但 存在 一 些 
不 同 之 处 ， 下 面 来 编写 一 个 类 进行 测试 。 来 看 一 个 帮助 管理 匿名 调查 的 类 : 


survey.py 


class AnonymousSurvey(): 


"" "收集 匿名 调查 问卷 的 答案 """ 


© def init (self, question): 
"" "存储 一 个 问题 ， 并 为 存储 答案 做 准备 """ 
self.question = question 
self.responses = [] 


@ def show question(self) 
mn 显示 调查 问卷 """ 
print(question) 


3 def store response(self, new response) 
mu 存储 单 份 调查 答卷 """ 


self.responses.append(new response) 


@ def show results(self): 
"" "显示 收集 到 的 所 有 答卷 """ 
print("Survey results:") 
for response in responses: 
print('- ' + response) 


这 个 类 首先 存储 了 一 个 你 指定 的 调查 问题 ( 见 @ )， 并 创建 了 一 个 空 列表 ， 用 于 存储 答案 。 
这 个 类 包含 打印 调查 问题 的 方法 ( 见 @ )、 在 答案 列表 中 添加 新 答案 的 方法 ( 见 @ ) 以 及 将 存储 
在 列表 中 的 答案 都 打印 出 来 的 方法 ( 见 @ )。 要 创建 这 个 类 的 实例 ， 只 需 提供 一 个 问题 即 可 。 有 
了 表示 调查 的 实例 后 ， 就 可 使 用 show_question() 来 显示 其 中 的 问题 ， 可 使 用 store_response() 来 
存储 答案 ， 并 使 用 show_results() 来 显示 调查 结果 。 

为 证 明 AnonymousSurvey 类 能 够 正确 地 工作 ， 我 们 来 编写 一 个 使 用 它 的 程序 : 


language_survey.py 


from survey import AnonymousSurvey 


# 定 义 一 个 问题 ， 并 创建 一 个 表示 调查 的 AnonymousSuTvey 对 象 
question = "What language did you first learn to speak?" 
my_survey = AnonymousSurvey(question) 


# 显 示 问 题 并 存储 答案 
my_survey.show question() 
print("Enter 'q' at any time to quit.\n") 
while True: 
response = input("Language: ") 
if response == "'q': 
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break 
my_survey.store response(response) 


# 显示 调查 结果 
print("\nThank you to everyone who participated in the survey!") 
my_survey.show results() 


这 个 程序 定义 了 一 个 问题 ("What language did you first learn to speak? " )， 并 使 用 这 个 
问题 创建 了 一 个 AnonymousSurvey 对 象 。 接 下 来 ， 这 个 程序 调用 show_question() 来 显示 问题 ， 并 
提示 用 户 输入 答案 。 收 到 每 个 答案 的 同时 将 其 存储 起 来 。 用 户 输入 所 有 答案 (输入 q 要 求 退出 ) 


后 ， 调 用 show results() 来 打印 调查 结果 : 


hat language did you first learn to speak? 
Enter 'q' at any time to quit. 


Language: English 

Language: Spanish 

Language: English 

Language: Mandarin 
Language: q 


Thank you to everyone who participated in the survey! 
Survey results: 

- English 

- Spanish 

- English 

- Mandarin 


AnonymousSurvey 类 可 用 于 进行 简单 的 匿名 调查 。 假 设 我 们 将 它 放 在 了 模块 survey 中 ,并 想 进 
行 改进 : 让 每 位 用 户 都 可 输入 多 个 答案 ; 编写 一 个 方法 ， 它 只 列 出 不 同 的 答案 ,并 指出 每 个 答案 
出 现 了 多 少 次 ; 再 编写 一 个 类 ， 用 于 管理 非 匿名 调查 。 

进行 上 述 修改 存在 风险 ,可 能 会 影响 AnonymousSurvey 类 的 当前 行为 。 例 如 ， 人 允许 每 位 用 户 输 
入 多 个 答案 时 , 可 能 不 小 心 修改 了 处 理 单个 答案 的 方式 。 要 确认 在 开发 这 个 模块 时 没有 破坏 既 有 
行为 ， 可 以 编写 针对 这 个 类 的 测试 。 


11.2.3 ”测试 AnonymousSurvey 类 

下 面 来 编写 一 个 测试 , 对 AnonymousSurvey 类 的 行为 的 一 个 方面 进行 验证 : 如 果 用 户 面 对 调查 
问题 时 只 提供 了 一 个 答案 ， 这 个 答案 也 能 被 妥善 地 存储 。 为 此 ,我 们 将 在 这 个 答案 被 存储 后 ,使 
用 方法 assertIn() 来 核实 它 包 含 在 答案 列表 中 : 


test_ survey.py 


import unittest 
from survey import AnonymousSurvey 


@ class TestAnonmyousSurvey(unittest.TestCase): 
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""" 针 对 AnonymousSurvey 类 的 测试 """ 


@ def test store single response(self): 

"" "测试 单 个 答案 会 被 妥善 地 存储 """ 

question = "What language did you first learn to speak?" 
3 my_survey = AnonymousSurvey(question) 

my_survey.store response('English') 


M49 self.assertIn('English', my_survey.responses) 


unittest.main() 


我 们 首先 导入 了 模块 unittest 以 及 要 测试 的 类 AnonymousSurvey。 我 们 将 测试 用 例 命名 为 
TestAnonymousSurvey， 它 也 继承 了 unittest.TestCase ( 见 @ )。 第 一 个 测试 方法 验证 调查 问题 的 
单个 答案 被 存储 后 ,会 包含 在 调查 结果 列表 中 。 对 于 这 个 方法 ,一 个 不 错 的 描述 性 名 称 是 
test_store_single_response()( 见 @ )。 如 果 这 个 测试 未 通过 ， 我 们 就 能 通过 输出 中 的 方法 名 得 
知 ， 在 存储 单个 调查 答案 方面 存在 问题 。 

要 测试 类 的 行为 , 需要 创建 其 实例 ,在 @ 处 ,我 们 使 用 问题 "What language did you first learn 
to speak?" 创 建 了 一 个 名 为 my_survey 的 实例 ， 然 后 使 用 方法 store response() 存 储 了 单个 答案 
English。 接 下 来 ,我 们 检查 English 是 否 包含 在 列表 my_survey.responses 中 ， 以 核实 这 个 答案 是 
否 被 妥善 地 存储 了 【( 见 @ )。 

当 我 们 运行 test_surveypy 时 ， 测 试 通过 了 : 


Ran 1 test in 0.001s 


OK 


这 很 好 , 但 只 能 收集 一 个 答案 的 调查 用 途 不 大 。 下 面 来 核实 用 户 提供 三 个 答案 时 , 它们 也 将 
被 妥善 地 存储 。 为 此 ， 我 们 在 TestAnonymousSurvey 中 再 添加 一 个 方法 : 


import unittest 
from survey import AnonymousSurvey 


class TestAnonymousSurvey(unittest.TestCase): 
""" 针 对 AnonymousSurvey 类 的 测试 """ 


def test store single response(self): 
”测试 单个 答案 会 被 妥善 地 存储 ”” 


--5170-- 


def test store three responses(self): 
"" "测试 三 个 答案 会 被 妥善 地 存储 """ 
question = "What language did you first learn to speak?" 
my_survey = AnonymousSurvey (question) 
@ responses = ['English', 'Spanish', "Mandarin ] 
for response in responses: 
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my_survey.store response(response) 


2 for response in responses: 
self.assertIn(response, my_survey.responses) 


unittest.main() 


我 们 将 这 个 方法 命名 为 test_store three responses()， 并 像 test store single response() 
一 样 ， 在 其 中 创建 一 个 调查 对 象 。 我 们 定义 了 一 个 包含 三 个 不 同 答案 的 列表 ( 见 @ )， 再 对 其 中 
每 个 答案 都 调用 store_response()。 存 储 这 些 答案 后 ， 我 们 使 用 一 个 循环 来 确认 每 个 答案 都 包含 
在 my_survey.responses 中 ( 见 @ )。 

我 们 再 次 运行 test_survey.py 时 ， 两 个 测试 ( 针对 单个 答案 的 测试 和 针对 三 个 答案 的 测试 ) 都 


Ran 2 tests in 0.000s 


OK 


前 述 做 法 的 效果 很 好 , 但 这 些 测试 有 些 重复 的 地 方 。 下 面 使 用 unittest 的 另 一 项 功能 来 提高 
它们 的 效率 。 


11.2.4 ”方法 setUp() 


在 前 面 的 test_survey.py 中 ,我 们 在 每 个 测试 方法 中 都 创建 了 一 个 AnonymousSurvey 实 例 ， 并 在 
每 个 方法 中 都 创建 了 答案 。unittest.TestCase 类 包含 方法 setup() ， 让 我 们 只 需 创 建 这 些 对 象 一 
次 ,并 在 每 个 测试 方法 中 使 用 它们 。 如 果 你 在 TestCase 类 中 包含 了 方法 setup() ，Python 将 先 运行 
它 ， 再 运行 各 个 以 test_ 打头 的 方法 。 这 样 ， 在 你 编写 的 每 个 测试 方法 中 都 可 使 用 在 方法 setup() 
中 创建 的 对 象 了 。 

下 面 使 用 setup() 来 创建 一 个 调查 对 象 和 一 组 答案 ， 供 方法 test_store_single_response() 和 
test_ store three responses() 使 用 : 


import unittest 
from survey import AnonymousSurvey 


class TestAnonymousSurvey(unittest.TestCase): 
""" 针 对 AnonymousSurvey 类 的 测试 """ 


def setUp(self): 
创建 一 个 调查 对 象 和 一 组 答案 , 供 使 用 的 测试 方法 使 用 
question = "What language did you first learn to speak?" 


@ self.my_survey = AnonymousSurvey(question) 
@ self.responses = ['English', 'Spanish', 'Mandarin'] 
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def test store single response(self) 
" "测试 单个 答案 会 被 要 普 地 存储 """ 
self.my_survey.store response(self.responses[0]) 
self.assertIn(self.responses[0], self.my survey.responses) 


def test store three responses(self) 
"" "测试 三 个 答案 会 被 妥善 地 存储 """ 
for response in self.responses: 
self.my_survey.store response(response) 
for response in self.responses: 
self.assertIn(response, self.my_ survey.responses) 


unittest.main() 


方法 setUp() 做 了 两 件 事情 : 创建 一 个 调查 对 象 ( 见 @ ); 创建 一 个 答案 列表 ( 见 @ )。 存储 这 
两 样 东 西 的 变量 名 包含 前 级 self( 即 存储 在 属性 中 )， 因 此 可 在 这 个 类 的 任何 地 方 使 用 。 这 让 两 
个 测试 方法 都 更 简单 ， 因 为 它们 都 不 用 创建 调查 对 象 和 答案 。 方 法 test_store three_response() 
核实 self.responses 中 的 第 一 个 答案 self.responses[0] 被 妥善 地 存储 ， 而 方法 
test _ store three Tesponse() 核 实 self.responses 中 的 全 部 三 个 答案 都 被 妥善 地 存储 。 
再 次 运行 test_surveypy 时 ， 这 两 个 测试 也 都 通过 了 。 如 果 要 扩展 AnonymousSurvey， 使 其 允许 
每 位 用 户 输入 多 个 答案 ， 这 些 测试 将 很 有 用 。 修 改 代 码 以 接受 多 个 答案 后 ， 可 运行 这 些 测 试 ， 确 
认 存 储 单个 答案 或 一 系列 答案 的 行为 未 受 影 响 。 

测试 自己 编写 的 类 时 ， 方法 setUp() 让 测试 方法 编写 起 来 更 容易 : 可 在 setUp() 方 法 中 创建 一 
系列 实例 并 设置 它们 的 属性 , 再 在 测试 方法 中 直接 使 用 这 些 实例 。 相 比 于 在 每 个 测试 方法 中 都 创 
建 实例 并 设置 其 属性 ， 这 要 容易 得 多 。 


注意 运行 测试 用 例 时 ， 每 完成 一 个 单元 测试 ，Python 都 打印 一 个 字符 : 测试 通过 时 打印 一 个 
句点 ; 测试 引发 错误 时 打印 一 个 E; 测试 导致 断言 失败 时 打印 一 个 F。 这 就 是 你 运行 测试 
用 例 时 ， 在 输出 的 第 一 行 中 看 到 的 句点 和 字符 数量 各 不 相同 的 原因 。 如 果 测 试用 例 包 含 
很 多 单元 测试 ， 需 要 运行 很 长 时 间 ， 就 可 通过 观察 这 些 结果 来 获悉 有 多 少 个 测试 通过 了 。 


动手 试 一 斌 
11-3 雇员 : 编写 一 个 名 为 Employee 的 类 ， 其 方法 init () 接 受 名 、 姓 和 年 薪 , 并 
将 它们 都 存储 在 属性 中 。 编 写 一 个 名 为 give iaise() 的 方法 ， 它 默认 将 年 薪 增 加 5000 


美元 ， 但 也 能 够 接受 其 他 的 年 薪 增 加 量 。 

为 Employee 编写 一 个 测试 用 例 ， 其 中 包含 两 个 测试 方法 : test give default_ 
raise() 和 test give custom raise()。 使 用 方法 setUp()， 以 免 在 每 个 测试 方法 中 都 创 
建新 的 雇员 实例 。 运 行 这 个 测试 用 例 ， 确 认 两 个 测试 都 通过 了 。 
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在 本 章 中 ， 你 学 习 了 : 如 何 使 用 模块 unittest 中 的 工具 来 为 函数 和 类 编写 测试 ; 如 何 编 写 继 
承 unittest.TestCase 的 类 ， 以 及 如 何 编写 测试 方法 ,以 核实 函数 和 类 的 行为 符合 预期 ; 如 何 使 用 
方法 setUp() 来 根据 类 高 效 地 创建 实例 并 设置 其 属性 ,以 便 在 类 的 所 有 测试 方法 中 都 可 使 用 它们 。 

测试 是 很 多 初学 者 都 不 熟悉 的 主题 。 作 为 初学 者 ， 并 非 必须 为 你 尝试 的 所 有 项 目 编写 测试 ; 
但 参与 工作 量 较 大 的 项 目 时 , 你 应 对 自己 编写 的 函数 和 类 的 重要 行为 进行 测试 。 这 样 你 就 能 够 更 
加 确定 自己 所 做 的 工作 不 会 破坏 项 目的 其 他 部 分 ,你 就 能 够 随心 所 欲 地 改进 既 有 代码 了 。 如 果 不 
小 心 破坏 了 原来 的 功能 , 你 马上 就 会 知道 ， 从 而 能 够 轻松 地 修复 问题 。 相 比 于 等 到 不 满意 的 用 户 
报告 bug 后 再 采取 措施 ， 在 测试 未 通过 时 采取 措施 要 容易 得 多 。 


如 果 你 在 项 目 中 包含 了 初步 测试 , 其 他 程序 员 将 更 敬佩 你 , 他 们 将 能 够 更 得 心 应 手 地 尝试 使 
用 你 编写 的 代码 ,也 更 愿意 与 你 合作 开发 项 目 。 如 果 你 要 跟 其 他 程序 员 开 发 的 项 目 共享 代码 ,就 


必须 证 明 你 编写 的 代码 通过 了 既 有 测试 ， 通 常 还 需要 为 你 添加 的 新 行为 编写 测试 。 


请 通过 多 开展 测试 来 熟悉 代码 测试 过 程 。 对 于 自己 编写 的 函数 和 类 , 请 编写 针对 其 重要 行为 


的 测试 ， 但 在 项 目 早期 ， 不 要 试图 去 编写 全 覆盖 的 测试 月 


目 例 ， 除 非 有 充分 的 理由 这 样 做 。 


祝贺 你 ! 你 现在 已 对 Python 有 了 足够 的 认识 ， 可 以 开始 开发 有 意思 的 交互 式 项 目 了 。 通 过 
动手 开发 项 目 ， 可 学 到 新 技能 ， 并 更 深入 地 理解 第 一 部 分 介绍 的 概念 。 
第 二 部 分 包含 三 个 不 同类 型 的 项 目 ， 你 可 以 选择 完成 其 中 的 任何 项 目 或 全 部 项 目 ， 完 成 这 
些 项 目的 顺序 无 关 紧要 。 下 面 简要 地 描述 每 个 项 目 ， 帮 助 你 决定 首先 去 完成 哪个 项 目 。 

外 星人 入 侵 : 使 用 Python 开发 游戏 

在 项 目 “ 外 星人 入 侵 ”( 第 12~14 章 ) 中 ， 你 将 使 用 Pygame 包 来 开发 一 款 2D 游戏 ， 它 在 
玩家 每 消灭 一 群 向 下 移动 的 外 星人 后 ， 都 将 玩家 提高 一 个 等 级 ; 而 等 级 越 高 ， 游 戏 的 节奏 越 快 ， 
难度 越 大 。 完 成 这 个 项 目 后 ， 你 将 获得 自己 动手 使 用 Pygame 开发 2D 游戏 所 需 的 技能 。 

数据 可 视 化 

“数据 可 视 化 ”项 目 始 于 第 15 章 ， 在 这 ， 你 将 学 习 如 何 使 用 matplotlib 和 Pygal 来 生 
成 数据 ， 以 及 根据 这 些 数据 创建 实用 而 漂亮 的 图 表 。 第 16 章 介绍 如 何 从 网 上 获取 数据 ， 并 将 它 
们 提供 给 可 视 化 包 以 创建 天 气 图 和 世界 人 口 地 图 。 最 后 ， 第 17 章 介 绍 如 何 编写 自动 下 载 数据 并 
对 其 进行 可 视 化 的 程序 。 学 习 可 视 化 让 你 可 以 探索 数据 挖掘 领域 ,这 是 当前 在 全 球 都 非常 吃 
的 技能 。 

Web 应 用 程序 

在 “Web 应 用 程序 ”项 目 (第 18~20 章 ) 中 ， 你 将 使 用 Django 包 来 创建 一 个 简单 的 Web 
应 用 程序 ， 它 让 用 户 能 够 记录 任意 多 个 一 直 在 学 习 的 主题 。 用 户 将 通过 指定 用 户 名 和 密码 来 创 
建 账户 ， 输 入 主题 ， 并 编写 条 目 来 记录 学 习 的 内 容 。 你 还 将 学 习 如 何 部 署 应 用 程序 ， 让 世界 上 
的 任何 人 都 能 够 访问 它 。 

完成 这 个 项 目 后 ， 你 将 能 够 自己 动手 创建 简单 的 Web 应 用 程序 ， 并 能 够 深入 学 习 其 他 有 关 
如 何 使 用 Django 开发 应 用 程序 的 资料 。 


| 
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我 们 来 开发 一 个 游戏 吧 ! 我 们 将 使 用 Pygame， 这 是 一 组 功能 强 
大 而 有 趣 的 模块 ， 可 用 于 管理 图 形 、 动 画 乃 至 声音 ,让 你 能 够 更 轻松 
地 开发 复杂 的 游戏 。 通 过 使 用 Pygame 来 处 理 在 屏幕 上 绘制 图 像 等 任 
务 , 你 不 用 考虑 众多 烦琐 而 艰难 的 编码 工作 , 而 是 将 重点 放 在 程序 的 
高 级 逻辑 上 。 

在 本 章 中 ， 你 将 安装 Pygame， 再 创建 一 艘 能够 根据 用 户 输入 而 
左右 移动 和 射击 的 飞船 。 在 接 下 来 的 两 章 中 , 你 将 创建 一 群 作 为 射 杀 
目标 的 外 星人 ,并 做 其 他 的 改进 , 如 限制 可 供 玩 家 使 用 的 飞船 数 以 及 
添加 记分 牌 。 

从 本 章 开 始 ， 你 还 将 学 习 管 理 包含 多 个 文件 的 项 目 。 我 们 将 重 构 很 多 代码 ， 以 提高 代码 
的 效率 ， 并 管理 文件 的 内 容 ， 以 确保 项 目 组 织 有 序 。 

创建 游戏 是 趣 学 语言 的 理想 方式 。 看 别人 玩 你 编写 的 游戏 让 你 很 有 满足 感 ， 而 编写 简单 
的 游戏 有 助 于 你 明白 专 业 级 游戏 是 怎么 编写 出 来 的 。 在 阅读 本 章 的 过 程 中 , 请 动手 输入 并 运 
行 代 码 ， 以 明白 各 个 代码 块 对 整个 游戏 所 做 的 贡献 ， 并 尝试 不 同 的 值 和 设置 ， 这 样 你 将 对 如 
何 改进 游戏 的 交互 性 有 更 深入 的 认识 。 


注意 游戏 《外 星人 入 侵 》 将 包含 很 多 不 同 的 文件 ， 因 此 请 在 你 的 系统 中 新 建 一 个 文件 夹 ， 并 
将 其 命名 为 alien invasion。 请 务必 将 这 个 项 目的 所 有 文件 都 存储 到 这 个 文件 夹 中 ， 这样 
相关 的 import 语 句 才 能 正确 地 工作 。 


12.1 规划 项 目 


开发 大 型 项 目 时, 做 好 规划 后 再 动手 编写 项 目 很 重要 。 规 划 可 确保 你 不 偏离 轨道 ， 从 而 提高 
项 目 成 功 的 可 能 性 。 
下 面 来 编写 有 关 游 戏 《 外 星人 入 侵 》 的 描述 ， 其 中 虽然 没有 涵盖 这 款 游戏 的 所 有 细节 ,但 能 
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让 你 清楚 地 知道 该 如 何 动手 开发 它 。 


在 游戏 《外 星人 入 侵 》 中 ,玩家 控制 着 一 般 最 初出 现在 屏幕 底部 中 央 的 飞船 。 玩 家 
可 以 使 用 箭头 键 左右 移动 飞船 ， 还 可 使 用 空格 键 进行 射击 。 游 戏 开始 时 ， 一 群 外 星人 出 
现在 天 空中 ,他 们 在 屏幕 中 向 下 移动 。 玩 家 的 任务 是 射 杀 这 些 外 星人 。 玩家 将 所 有 外 星 
人 都 消灭 干净 后 ， 将 出 现 一 群 新 的 外 星人 ， 他 们 移动 的 速度 更 快 。 只 要 有 外 星人 撞 到 了 
玩家 的 飞船 或 到 达 了 屏幕 底部 , 玩家 就 损失 一 般 飞 船 。 玩家 损失 三 艘 飞船 后 , 游戏 结束 。 


在 第 一 个 开发 阶段 , 我 们 将 创建 一 艘 可 左右 移动 的 飞船 , 这 艘 飞船 在 用 户 按 空格 键 时 能 够 开 
火 。 设 置 好 这 种 行为 后 ， 我 们 就 能 够 将 注意 力 转 向 外 星人 ， 并 提高 这 款 游戏 的 可 玩 性 。 
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开始 编码 前 ， 先 来 安装 Pygame。 下 面 介 绍 如 何在 Linux、OS X 和 Microsoft Windows 中 安装 
Pygame。 

如 果 你 使 用 的 是 Linux 系 统 和 Python 3， 或 者 是 OS X 系 统 ， 就 需要 使 用 pip 来 安装 Pygame。pip 
是 一 个 负责 为 你 下 载 并 安装 Python 包 的 程序 。 接 下 来 的 几 小 节 介 绍 如 何 使 用 pip 来 安装 Python 包 。 

如 果 你 使 用 的 是 Linux 系 统 和 Python 2.7, 或 者 是 Windows， 就 无 需 使 用 pip 来 安装 Pygame; 在 
这 种 情况 下 ， 请 直接 跳 到 12.2.2 节 或 12.2.4 节 。 


注意 接 下 来 的 部 分 包含 在 各 种 系统 上 安装 pip 的 说 明 ， 因 为 数据 可 视 化 项 目 和 Web 应 用 程序 项 
目 都 需要 pip。 这 些 说 明 也 可 在 https://www.nostarch.com/pythoncrashcourse/ 在 线 资 源 中 找 
到 。 如 果 安 装 时 遇 到 麻烦 ， 看 看 在 线 说 明 是 否 管用 。 


12.2.1 使 用 pip 安装 Python 包 


大 多 数 较 新 的 Python 版 本 都 自 带 pip， 因 此 首先 可 检查 系统 是 否 已 经 安装 了 pip。 在 Python 3 
中 ，pip 有 了 时 被 称 为 pip3。 

1. 在 Linux 和 OS X 系 统 中 检查 是 否 安装 了 pip 

打开 一 个 终端 窗口 ， 并 执行 如 下 命令 : 


$ pip --version 
@ pip 7.0.3 from /usr/local/lib/python3.5/dist-packages (python 3.5) 
$ 


如 果 你 的 系统 只 安装 了 一 个 版 本 的 Python， 并 看 到 了 类 似 于 上 面 的 输出 ， 请 跳 到 12.2.2 节 或 
12.2.3 节 。 如 果 出 现 了 错误 消息 ， 请 尝试 将 pip 替 换 为 pip3。 如 果 这 两 个 版 本 都 没有 安装 到 你 的 系 
统 中 ， 请 跳 到 “安装 pip”。 

如 果 你 的 系统 安装 了 多 个 版 本 的 Python， 请 核实 pip 关 联 到 了 你 使 用 的 Python 版 本 ， 如 python 
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3.5( 见 @ )。 如果 pip 关 联 到 了 正确 的 Python 版 本 , 请 跳 到 12.2.2 节 或 12.2.3 节 。 如 果 pip 没 有 关联 到 
正确 的 Python 版 本 ， 请 尝试 将 pip 替 换 为 pip3。 如 果 执 行 这 两 个 命令 时 ， 输 出 都 表明 没有 关联 到 正 
确 的 Python 版 本 ， 请 跳 到 “安装 pip”。 

2. 在 Windows 系 统 中 检查 是 否 安装 了 pip 

打开 一 个 终端 窗口 ， 并 执行 如 下 命令 : 


$ python -m pip --version 
@ pip 7.0.3 from C:\Python35\lib\site-packages (python 3.5) 
$ 


如 果 你 的 系统 只 安装 了 一 个 版 本 的 Python， 并 看 到 了 类 似 于 上 面 的 输出 ， 请 跳 到 12.2.4 节 。 
如 果 出 现 了 错误 消息 , 请 尝试 将 pip 替 换 为 pip3。 如 果 执 行 这 两 个 命令 时 都 出 现 错误 消息 , 请 跳 到 
“安装 pip”。 

如 果 你 的 系统 安装 了 多 个 版 本 的 Python， 请 核实 pip 关 联 到 了 你 使 用 的 Python 版 本 ， 如 python 
3.5( 见 @ )。 如 果 pip 关 联 到 了 正确 的 Python 版 本 , 请 跳 到 12.2.4 节 。 如 果 pip 没 有 关联 到 正确 的 Python 
版 本 ,请 尝试 将 pip 蔡 换 为 pip3。 如 果 执 行 这 两 个 命令 时 都 出 现 错 误 消 息 ， 请 跳 到 “安装 pip”。 

3. 安装 pip 

要 安装 pip， 请 访问 https://bootstrap.pypa.io/get-pip.py。 如 果 出 现 对 话 框 ， 请 选择 保存 文件 ; 
如 果 get-pip.py 的 代码 出 现在 浏览 器 中 , 请 将 这 些 代码 复制 并 粘贴 到 文本 编辑 器 中 , 再 将 文件 保存 
为 get-pip.py。 将 get-pip.py 保 存 到 计算 机 中 后 ， 你 需要 以 管理 员 身 份 运行 它 ， 因 为 pip 将 在 你 的 系 
统 中 安装 新 包 。 


注意 ”如 果 你 找 不 到 get-pip.py， 请 访问 https://pip.pypa.io/， 单 击 左 边 面板 中 的 Installation， 再 单 
击 中 间 窗口 中 的 链接 get-pip.py。 


4. 在 Linux 和 OS X 系 统 中 安装 pip 
使 用 下 面 的 命令 以 管理 员 身 份 运行 get-pip.py; 


$ sudo python get-pip.py 


注意 如 果 你 启动 终端 会 话 时 使 用 的 是 命令 python3， 那 么 在 这 里 应 使 用 命令 sudo python3 
get-pip.py。 


这 个 程序 运行 后 ， 使 用 命令 pip --version (或 pip3 --version ) 确认 正确 地 安装 了 pip。 
5. 在 Windows 系 统 中 安装 pip 
使 用 下 面 的 命令 运行 get-pip.py: 


$ python get-pip.py 


206 第 12 章 武装 飞船 


如 ， 


如 果 你 在 终端 中 运行 Python 时 使 用 的 是 另 一 个 命令 , 也 请 使 用 这 个 命令 来 运行 get-pip.py。 例 
你 可 能 需要 使 用 命令 python3 get-pip.py 或 C:\Python35\python get-pip.py。 
这 个 程序 运行 后 ， 执 行 命令 python -m pip --version 以 确认 成 功 地 安装 了 pip。 


12.2.2 在 Linux 系统 中 安装 Pygame 


执行 


二 
上 请 百 


到 。 


如 果 你 使 用 的 是 Python 2.7， 请 使 用 包 管 理 器 来 安装 Pygame。 为 此 ， 打 开 一 个 终端 窗口 ， 并 
下 面 的 命令 ， 这 将 下 载 Pygame， 并 将 其 安装 到 你 的 系统 中 : 


$ sudo apt-get install python-pygame 


执行 如 下 命令 ， 在 终端 会 话 中 检查 安装 情况 : 


$ python 
>>> import pygame 
>>> 


如 果 没 有 任何 输出 ， 就 说 明 Python 导 入 了 Pygame， 你 可 以 跳 到 12.3 节 。 
如 果 你 使 用 的 是 Python 3, 就 需要 执行 两 个 步骤 : 安装 Pygame 依 赖 的 库 ; 下 载 并 安装 Pygame。 
执行 下 面 的 命令 来 安装 Pygame 依 赖 的 库 ( 如 果 你 开始 终端 会 话 时 使 用 的 是 命令 python3.5， 


请 将 python3-dev 替 换 为 python3.5-dev ): 


$ sudo apt-get install python3-dev mercurial 
$ sudo apt-get install libsdl-image1.2-dev libsdl2-dev libsdl-ttf2.0-dev 


这 将 安装 运行 《外 星人 入 侵 》 时 需要 的 库 。 如 果 你 要 启用 Pygame 的 一 些 高 级 功能 ， 如 添加 
的 功能 ， 可 安装 下 面 这 些 额 外 的 库 : 


$ sudo apt-get install libsdl-mixer1.2-dev libportmidi-dev 
$ sudo apt-get install libswscale-dev libsmpeg-dev libavformat-dev libavcode-dev 
$ sudo apt-get install python-numpy 


接 下 来 ， 执 行 下 面 的 命令 来 安装 Pygame ( 如 有 必要 ， 将 pip 替 换 为 pip3 ): 


$ pip install --user hg+http://bitbucket.org/pygame/pygame 


告知 你 Pygame 找 到 了 哪些 库 后 ， 输 出 将 暂停 一 段 时 间 。 请 按 回 车 键 ， 即 便 有 一 些 库 没有 找 
你 将 看 到 一 条 消息 ， 说 明成 功 地 安装 了 Pygame。 
要 确认 安装 成 功 ， 请 启动 一 个 Python 终端 会 话 ， 并 尝试 执行 下 面 的 命令 来 导入 Pygame; 


$ python3 
>>> import pygame 
>>> 


如 果 导 入 成 功 ， 请 跳 到 12.3 节 。 
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12.2.3 在 OS X 系 统 中 安装 Pygame 

要 安装 Pygame 依 赖 的 有 些 包 ,需要 Homebrew。 如 果 你 没有 安装 Homebrew， 请 参阅 附录 A 的 
说 明 。 

为 安装 Pygame 依 赖 的 库 ， 请 执行 下 面 的 命令 : 


$ brew install hg sdl] sdl image sd] ttf 


这 将 安装 运行 游戏 《外 星人 入 侵 》 所 需 的 库 。 每 安装 一 个 库 后 ， 输 出 都 会 向 上 滚动 。 
如 果 你 还 想 启用 较 高 级 的 功能 ， 如 在 游戏 中 包含 声音 ， 可 安装 下 面 两 个 额外 的 库 : 


$ brew install sdl] mixer portmidi 


使 用 下 面 的 命令 来 安装 Pygame ( 如 果 你 运行 的 是 Python 2.7， 请 将 pip3 替 换 为 pip ): 


$ pip3 install --user hg+http://bitbucket.org/pygame/pygame 


启动 一 个 Python 终端 会 话 ， 并 导入 Pygame 以 检查 安装 是 否 成 功 (如果 你 运行 的 是 Python 2.7， 
请 将 python3 替 换 为 python ): 


$ python3 
>>> import pygame 
>>> 


如 果 导 入 成 功 ， 请 跳 到 12.3 节 。 


12.2.4 在 Windows 系统 中 安装 Pygame 


Pygame 项 目 托管 在 代码 分 享 网 站 Bitbucket 中 。 要 在 Windows 系 统 中 安装 Pygame ， 请 访问 
https:/bitbucket.org/pygame/pygame/downloads/， 查 找 与 你 运行 的 Python 版 本 匹配 的 Windows 安 装 
程序 。 如 果 在 Bitbucket 上 找 不 到 合适 的 安装 程序 ， 请 去 http://www.lfd.uci.edu/~gohlke/pythonlibs/ 
#pygame 看 看 。 

下 载 合适 的 文件 后 ， 如 果 它 是 .exe 文 件 ， 就 运行 它 。 

如 果 该 文件 的 扩展 名 为 .whl， 就 将 它 复制 到 你 的 项 目 文件 夹 中 。 再 打开 一 个 命令 窗口 ， 切 换 
到 该 文件 所 在 的 文件 夹 ， 并 使 用 pip 来 运行 它 : 


> python -m pip install --user pygame-1.9.2a0-cp35-none-win32.whl 


12.3 ”开始 游戏 项 目 


现在 来 开始 开发 游戏 《外 星人 入 侵 》 首先 创建 一 个 空 的 Pygame 窗 口 ， 供 后 面 用 来 绘制 游戏 
元 素 ， 如 飞船 和 外 星人 。 我 们 还 将 让 这 个 游戏 响应 用 户 输入 、 设 置 背景 色 以 及 加 载 飞船 图 像 。 
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12.3.1 创建 Pygame 窗口 以 及 响应 用 户 输入 
首先 ， 我们 创建 一 个 空 的 Pygame 窗 口 。 使 用 Pygame 编 写 的 游戏 的 基本 结构 如 下 : 


alien_invasion.py 


import sys 
import pygame 


def run game(): 
# 初始 化 游戏 并 创建 一 个 屏幕 对 象 
pygame.init() 
screen = pygame.display.set mode((1200, 800)) 
pygame.display.set caption("Alien Invasion") 


©®©® 


# 开始 游戏 的 主 循环 
© while True: 


# 监视 键盘 和 鼠标 事件 


@ for event in pygame.event.get(): 
© if event.type == pygame.QUIT: 
sys.exit() 
# 让 最 近 绘 制 的 屏幕 可 见 
© pygame.display.flip() 
run_game() 


首先 , 我 们 导入 了 模块 sys 和 pygame。 模块 pygame 包 含 开 发 游戏 所 需 的 功能 。 玩 家 退出 时 , 我 
们 将 使 用 模块 sys 来 退出 游戏 。 

游戏 《外 星人 入 侵 》 的 开头 是 函数 run_game()。@ 处 的 代码 行 pygame.init() 初 始 化 背景 设置 ， 
让 Pygame 能 够 正确 地 工作 。 在 @ 处 ,我 们 调用 pygame .display.set_mode() 来 创建 一 个 名 为 screen 
的 显示 窗口 ， 这 个 游戏 的 所 有 图 形 元 素 都 将 在 其 中 绘制 。 实 参 (1200，800) 是 一 个 元 组 ， 指 定 了 
游戏 窗口 的 尺寸 。 通 过 将 这 些 尺 寸 值 传递 给 pygame.display.set_mode()， 我 们 创建 了 一 个 宽 1200 
像素 、 高 800 像 素 的 游戏 窗口 (你 可 以 根据 自己 的 显示 器 尺寸 调整 这 些 值 )。 
对 象 screen 是 一 个 surface。 在 Pygame 中 ，surface 是 屏幕 的 一 部 分 ， 用 于 显示 游戏 元 素 。 在 这 
个 游戏 中 ， 每 个 元 素 ( 如 外 星人 或 飞船 ) 都 是 一 个 surface。display.set_mode() 返 回 的 surface 表 
示 整 个 游戏 窗口 。 我 们 激活 游戏 的 动画 循环 后 ， 每 经 过 一 次 循环 都 将 自动 重 绘 这 个 surface。 

这 个 游戏 由 一 个 while 循 环 ( 见 @ ) 控制 ， 其 中 包含 一 个 事件 循环 以 及 管理 屏幕 更 新 的 代码 。 
事件 是 用 户 玩 游戏 时 执行 的 操作 ， 如 按键 或 移动 鼠标 。 为 让 程序 响应 事件 , 我 们 编写 一 个 事件 循 
环 ， 以 侦 听 事件 ， 并 根据 发 生 的 事件 执行 相应 的 任务 。@ 处 的 for 循 环 就 是 一 个 事件 循环 。 

为 访问 Pygame 检 测 到 的 事件 ， 我 们 使 用 方法 pygame.event.get()。 所 有 键盘 和 鼠标 事件 都 将 
促使 for 循 环 运行 。 在 这 个 循环 中 ,我 们 将 编写 一 系列 的 if 语 句 来 检测 并 响应 特定 的 事件 。 例 如 ， 
玩家 单 击 游戏 窗口 的 关闭 按钮 时 , 将 检测 到 pygame.0QUIT 事 件 , 而 我 们 调用 sys .exit() 来 退出 游戏 
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( 见 @ )。 

@ 处 调用 了 pygame.display.flip(), 命令 Pygame 让 最 近 绘 制 的 屏幕 可 见 。 在 这 里 , 它 在 每 次 
执行 while 循 环 时 都 绘制 一 个 空 屏幕 ， 并 擦 去 旧 屏 幕 ， 使 得 只 有 新 屏幕 可 见 。 在 我 们 移动 游戏 元 
素 时 , pygame.display.flip() 将 不 断 更 新 屏幕 , 以 显示 元 素 的 新 位 置 , 并 在 原来 的 位 置 隐藏 元 素 ， 
从 而 营造 平滑 移动 的 效果 。 

在 这 个 基本 的 游戏 结构 中 ， 最 后 一 行 调用 run_game() ， 这 将 初始 化 游戏 并 开始 主 循环 。 

如 果 此 时 运行 这 些 代码 ， 你 将 看 到 一 个 空 的 Pygame 窗 口 。 


12.3.2 ”设置 背景 


Pygame 默 认 创 建 一 个 黑色 屏幕 ， 这 大 乏味 了 。 下 面 来 将 背景 设置 为 另 一 种 颜色 : 


alien_invasion.py 


--SNip-- 

def run game(): 
-- Ship-- 
pygame.display.set caption("Alien Invasion") 


# 设置 背景 色 
0 bg color = (230，230，230) 


# 开始 游戏 主 循环 . 
while True: 


# 监听 键盘 和 鼠标 事件 
-- Snip-- 


# 每 次 循环 时 都 重 绘 屏幕 
@ screen.fill(bg color) 


# 让 最 近 绘 制 的 屏幕 可 见 
pygame.display.flip() 


run game() 


首先 ， 我 们 创建 了 一 种 背景 色 ， 并 将 其 存储 在 bg_color 中 ( 见 @ )。 该 颜色 只 需 指定 一 次 ， 
因此 我 们 在 进入 主 while 循 环 前 定义 它 。 

在 Pygame 中 ， 颜 色 是 以 RGB 值 指定 的 。 这 种 颜色 由 红色 、 绿 色 和 蓝 色 值 组 成 ， 其 中 每 个 值 
的 可 能 取 值 范围 都 为 0~255。 颜 色 值 (255, 0, 0) 表 示 红 色 ，(0, 255, 0) 表 示 绿 色 ， 而 (0, 0, 255) 表 示 蓝 
色 。 通 过 组 合 不 同 的 RGB 值 ， 可 创建 1600 万 种 颜色 。 在 颜色 值 (230, 230, 230) 中 ， 红 色 、 蓝 色 和 
绿色 量 相 同 ， 它 将 背景 设置 为 一 种 浅 灰色 。 

在 @@ 处 ， 我 们 调用 方法 screen.fil1()， 用 背景 色 填 
种 颜色 。 
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12.3.3 创建 设置 类 


每 次 给 游戏 添加 新 功能 时 , 通常 也 将 引入 一 些 新 设置 .下面 来 编写 一 个 名 为 settings 的 模块 ， 
其 中 包含 一 个 名 为 Settings 的 类 , 用 于 将 所 有 设置 存储 在 一 个 地 方 , 以 免 在 代码 中 到 处 添加 设置 。 
这 样 ， 我们 就 能 传递 一 个 设置 对 象 ， 而 不 是 众多 不 同 的 设置 。 另 外， 这 让 函数 调用 更 简单 ， 且 在 
项 目 增 大 时 修改 游戏 的 外 观 更 容易 : 要 修改 游戏 ， 只 需 修 改 settings.py 中 的 一 些 值 ， 而 无 需 查 找 
散布 在 文件 中 的 不 同 设置 。 

下 面 是 最 初 的 Settings 类 : 


settings.py 


class Settings(): 
""" 和 存储 《外 星人 入 侵 》 的 所 有 设置 的 类 """ 


def init (self): 
""" 初 始 化 游戏 的 设置 """ 
# 屏幕 设置 
self.screen width = 1200 
self.screen height = 800 
self.bg color = (230，230，230) 


为 创建 settings 实 例 并 使 用 它 来 访问 设置 ， 将 alien_invasion.py 修 改 成 下 面 这 样 : 


alien_invasion.py 


-- SN1p-- 
import pygame 


from settings import Settings 


def run game(): 
# 初始 化 pygame、 设 置 和 屏幕 对 象 
pygame.init() 
© ai settings = Settings() 
@ screen = pygame.display.set mode( 
(ai settings.screen width, ai settings.screen height)) 
pygame.display.set caption("Alien Invasion") 


# 开始 游戏 主 循环 
while True : 
-- SNnip-- 
# 每 次 循环 时 部 重 绘 屏幕 
@ screen.fill(ai settings.bg color) 


# 让 最 近 绘 制 的 屏幕 可 见 


pygame.display.flip() 


run game() 
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在 主 程序 文件 中 ， 我 们 导入 Settings 类 ， 调 用 pygame.init() ， 再 创建 一 个 Settings 实 例 ， 并 
将 其 存储 在 变量 ai settings 中 ( 见 @ )。 创建 屏幕 时 ( 见 @ )， 使 用 了 ai settings 的 属性 
screen width 和 screen height; 接 下 来 填充 屏幕 时 ,也 使 用 了 ai settings 来 访问 背景 色 ( 见 @ )。 


12.4 添加 飞船 图 像 


下 面 将 飞船 如 入 到 游戏 中 。 为 了 在 屏幕 上 绘制 玩家 的 飞船 ， 我 们 将 加 载 一 幅 图 像 ， 再 使 用 
Pygame 方 法 blit() 绘 制 它 。 

为 游戏 选择 素材 时 ， 务 必要 注意 许可 。 最 安全 、 最 不 费 钱 的 方式 是 使 用 http:/pixabay.comy/ 等 
网 站 提供 的 图 形 ， 这 些 图 形 无 需 许 可 ， 你 可 以 对 其 进行 修改 。 

在 游戏 中 几乎 可 以 使 用 任何 类 型 的 图 像 文件 ,但 使 用 位 图 ( .bmp ) 文 件 最 为 简单 , 因为 Pygame 
默认 加 载 位 图 。 虽 然 可 配置 Pygame 以 使 用 其 他 文件 类 型 ， 但 有 些 文件 类 型 要 求 你 在 计算 机 上 安 
装 相应 的 图 像 库 。 大 多 数 图 像 都 为 jpg、.png 或 .gif 格式 ， 但 可 使 用 Photoshop 、GIMP 和 Paint 等 工 
具 将 其 转换 为 位 图 。 

选择 图 像 时 , 要 特别 注意 其 背景 色 。 请 尽 可 


选择 背景 透明 的 图 像 ， 这 样 可 使 用 图 像 编 辑 避 


el 


将 其 背景 设置 为 任何 颜色 。 图 像 的 背景 色 与 游戏 的 背景 色相 同时 , 游戏 看 起 来 最 漂亮 ; 你 也 可 以 
将 游戏 的 背景 色 设置 成 与 图 像 的 背景 色相 同 。 


就 游戏 《外 星人 入 侵 》 而 言 ， 你 可 以 使 用 文件 ship.bmp ( 如 图 12-1 所 示 )， 这 个 文件 可 在 本 书 
的 配套 资源 ( https://www.nostarch.com/pythoncrashcourse/ ) 中 找到 。 这 个 文件 的 背景 色 与 这 个 项 
目 使 用 的 设置 相同 。 请 在 主 项 目 文 件 夹 (alien_invasion ) 中 新 建 一 个 文件 夹 , 将 其 命名 为 images， 
并 将 文件 ship.bmp 保 存 到 这 个 文件 夹 中 。 


\ 


图 12-1 游戏 《外 星人 入 侵 》 中 的 飞船 
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12.4.1 创建 Ship 类 


选择 用 于 表示 飞船 的 图 像 后 ， 需 要 将 其 显示 到 屏幕 上 。 我 们 将 创建 一 个 名 为 snip 的 模块 ， 其 
中 包含 ship 类 ， 它 负责 管理 飞船 的 大 部 分 行为 。 


ship.py 


import pygame 
class Ship(): 


def init (self, screen): 


""" 初 始 化 飞船 并 设置 其 初始 位 置 """ 
self.screen = screen 


# 加 载 飞 船 图 像 并 获取 其 外 接 矩 形 

self.image = pygame.image.1load('images/ship.bmp') 
self.rect = self.image.get rect() 

self.screen rect = screen.get rect() 


@Q@e 


# 将 每 稻 新 飞船 放 在 屏幕 底部 中 央 
Q@ self.rect.centerx = self.screen rect.centerx 
self.rect.bottom = self.screen rect.bottom 


(5 def blitme(self): 
"" 在 指定 位 置 绘 制 飞船 """ 
elf.screen.blit(self.image, self.rect) 


th Pa 


首先 ， 我 们 导入 了 模块 pygame。Ship 的 方法 init () 接 受 两 个 参数 : 引用 self 和 screen， 
其 中 后 者 指定 了 要 将 飞船 绘制 到 什么 地 方 ,为 加 载 图 像 ,我 们 调用 了 pygame.image.1l0ad()( 见 @ )。 
这 个 函数 返回 一 个 表示 飞船 的 surface， 而 我 们 将 这 个 surface 存 储 到 了 self.image 中 。 

加 载 图 像 后 , 我 们 使 用 get_rect() 获 取 相 应 surface 的 属性 rect ( 见 @ )。Pygame 的 效率 之 所 以 
如 此 高 ， 一 个 原因 是 它 让 你 能 够 像 处 理 矩 形 (rect 对 象 ) 一 样 处 理 游戏 元 素 ， 即 便 它们 的 形状 并 
非 和 矩形 。 像 处 理 和 矩形 一 样 处 理 游戏 元 素 之 所 以 高 效 ， 是 因为 矩形 是 简单 的 几何 形状 。 这 种 做 法 的 
效果 通常 很 好 ， 游 戏 玩家 几乎 注意 不 到 我 们 处 理 的 不 是 游戏 元 素 的 实际 形状 。 

处 理 rect 对 象 时 , 可 使 用 矩形 四 角 和 中 心 的 x 和 y 符 标 。 可 通过 设置 这 些 值 来 指定 矩形 的 位 置 。 

要 将 游戏 元 素 居中 ， 可 设置 相应 rect 对 象 的 属性 center 、centerx 或 centery。 要 让 游戏 元 素 
与 屏幕 边缘 对 齐 ， 可 使 用 属性 top 、bottom 、left 或 right; 要 调整 游戏 元 素 的 水 平 或 垂直 位 置 ， 
可 使 用 属性 x 和 y， 它们 分 别 是 相应 矩形 左上 角 的 x 和 y 坐 标 。 这 些 属性 让 你 无 需 去 做 游戏 开发 人 员 
原本 需要 手工 完成 的 计算 ， 你 经 常会 用 到 这 些 属 性 。 


注意 ”在 Pygame 中 ， 原 点 (0, 0) 位 于 屏幕 左上 角 ， 向 右 下 方 移动 时 ， 坐 标 值 将 增 大 。 在 1200 x 800 
的 屏幕 上 ， 原 点 位 于 左上 角 ， 而 右 下 角 的 坐标 为 (1200, 800)。 
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我 们 将 把 飞船 放 在 屏幕 底部 中 央 。 为 此 ， 首 先 将 表示 屏幕 的 矩形 存储 在 self.screen rect 中 
( 见 @ )， 再 将 self.rect.centerx (飞船 中 心 的 x 坐标 ) 设置 为 表示 屏幕 的 矩形 的 属性 centerx( 见 
@ ), 并 将 self.rect.bottom( 飞船 下 边缘 的 ?坐标 ) 设置 为 表示 屏幕 的 矩形 的 属性 pottom。Pygame 
将 使 用 这 些 rect 属 性 来 放置 飞船 图 像 ， 使 其 与 屏幕 下 边缘 对 齐 并 水 平 居中 。 

在 @ 处 ， 我 们 定义 了 方法 blitme()， 它 根据 self.rect 指 定 的 位 置 将 图 像 绘 制 到 屏幕 上 。 


12.4.2 ”在 屏幕 上 绘制 飞船 
下 面 来 更 新 alien invasion.py， 使 其 创建 一 艘 飞船 ， 并 调用 其 方法 blitme(): 


alien_invasion.py 


-- Snip-- 
from settings import Settings 
from ship import Ship 


def run game(): 
-- Ship-- 
pygame.display.set caption("Alien Invasion") 


# 创建 一 般 飞 船 
© ship = Ship(screen) 


# 开始 游戏 主 循环 
while True: 
--SNnip-- 
# 每 次 循环 时 都 重 绘 屏幕 
screen.fill(ai settings.bg color) 
(2 ship.blitme() 


# 让 最 近 绘 制 的 屏幕 可 见 
pygame.display.flip() 


run_game() 


我 们 导入 Ship 类 , 并 在 创建 屏幕 后 创建 一 个 名 为 ship 的 Ship 实 例 。 必须 在 主 while 循 环 前 面 创 
建 该 实例 ( 见 @ )， 以 免 每 次 循环 时 都 创建 一 艘 飞船。 填充 背景 后 ， 我 们 调用 ship.blitme() 将 飞 
船 绘制 到 屏幕 上 ， 确 保 它 出 现在 背景 前 面 ( 见 @ )。 

现在 如 果 运 行 alien_invasion.py， 将 看 到 飞船 位 于 空 游 戏 屏幕 底部 中 央 ， 如 图 12-2 所 示 。 


会 


图 12-2 游戏 《外 星人 入 侵 》 屏 幕 底部 中 央 有 一 艘 飞船 


12.5 ” 重 构 : 模块 game functions 


在 大 型 项 目 中 , 经 常 需要 在 添加 新 代码 前 重 构 既 有 代码 。 重 构 旨 在 简化 既 有 代码 的 结构 ,使 
其 更 容易 扩展 。 在 本 节 中 ， 我 们 将 创建 一 个 名 为 game_functions 的 新 模块 ， 它 将 存储 大 量 让 游戏 
《外 星人 入 侵 》 运 行 的 函数 。 通 过 创建 模块 game _ functions， 可 避免 alien_ invasion.py 太 长 ， 并 使 
其 逻辑 更 容易 理解 。 


12.5.1 涵 数 check events() 


我 们 将 首先 把 管理 事件 的 代码 移 到 一 个 名 为 cneck_events() 的 函数 中 ， 以 简化 run game() 并 
隔离 事件 管理 循环 。 通 过 隔离 事件 循环 ， 可 将 事件 管理 与 游戏 的 其 他 方面 ( 如 更 新 屏幕 ) 分 离 。 
将 check_events() 放 在 一 个 名 为 game_functions 的 模块 中 : 


game_functions.py 


import sys 


import pygame 


def check events(): 
"" "响应 按键 和 和 鼠标 事件 """ 
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这 个 模块 中 导入 了 事件 检查 循环 要 使 用 的 sys 和 pygame。 当 前 ， 函 数 check_events() 不 需要 任 
何 形 参 ， 其 函数 体 复 制 了 alien invasion.py 的 事件 循环 。 

下 面 来 修改 alien invasion.py， 使 其 导入 模块 game_ functions， 并 将 事件 循环 替换 为 对 函数 
check_events() 的 调用 : 


alien_invasion.py 


import pygame 


from settings import Settings 
from ship import Ship 
import game functions as gf 


def run game(): 
-- Snip-- 
# 开始 游戏 主 循环 
while True: 
gf.check_events() 


# 让 最 近 绘 制 的 屏幕 可 见 
-- Snip-- 


在 主 程序 文件 中 , 不 再 需要 直接 导入 sys， 因为 当前 只 在 模块 game_functions 中 使 用 了 它 。 出 
于 简化 的 目的 ， 我 们 给 导入 的 模块 game_functions 指 定 了 别名 gf。 


12.5.2 ”水 数 update screen() 


为 进一步 简化 run_game()， 下 面 将 更 新 屏幕 的 代码 移 到 一 个 名 为 update_screen() 的 函数 中 ， 
并 将 这 个 函数 放 在 模块 game_functions.py 中 : 


game_functions.py 


-- SNip-- 


def check events(): 
-- Snip-- 


def update screen(ai settings, screen, ship): 
""" 更 新 屏幕 上 的 图 像 ， 并 切换 到 新 屏幕 """ 
# 每 次 循环 时 都 重 绘 屏幕 
screen.fill(ai settings.bg color) 
ship.blitme() 


# 让 最 近 绘 制 的 屏幕 可 见 
pygame.display.flip() 


新 函数 update screen() 包 含 三 个 形 参 : ai settings 、screen 和 ship 。 现 在 需要 将 
alien_invasion.py 的 while 循 环 中 更 新 屏幕 的 代码 替换 为 对 函数 update_scteen() 的 调用 : 
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gf.check events() 
gf.update screen(ai settings, screen, ship) 


run_ game() 


两 个 函数 让 while 循 环 更 简单 ， 并 让 后 续 开 发 更 容易 : 在 模块 game functions 而 不 是 
run_game() 中 完成 大 部 分 工作 。 
鉴于 我 们 一 开始 只 想 使 用 一 个 文件 ， 因 此 没有 立刻 引入 模块 game_functions。 这 让 你 能 够 了 
解 实际 的 开发 过 程 : 一 开始 将 代码 编写 得 尽 可 能 简单 ， 并 在 项 目 越 来 越 复杂 时 进行 重 构 。 
对 代码 进行 重 构 使 其 更 容易 扩展 后 ， 可 以 开始 处 理 游戏 的 动态 方面 了 ! 


动手 试 一 斌 


12-1 蓝 色 天 空 : 创建 一 个 背景 为 蓝 色 的 Pygame 窗口 。 


12-2 游戏 角色 : 找 一 幅 你 喜欢 的 游戏 角色 位 图 图 像 或 将 一 幅 图 像 转换 为 位 图 。 创 
建 一 个 类 ， 将 该 角色 绘制 到 屏幕 中 央 ， 并 将 该 图 像 的 背景 色 设 置 为 屏幕 背景 色 ， 或 将 屏 
幕 背 景色 设置 为 该 图 像 的 背景 色 。 


12.6 ”驾驶 飞船 


下 面 来 让 玩家 能 够 左右 移动 飞船 。 为 此 , 我 们 将 编写 代码 , 在 用 户 按 左 或 右 箭 头 键 时 作出 响 
应 。 我 们 将 首先 专注 于 向 右 移 动 ， 再 使 用 同样 的 原理 来 控制 向 左 移动 。 通 过 这 样 做 ,你 将 学 会 如 
何 控制 屏幕 图 像 的 移动 。 


12.6.1 响应 按键 


每 当 用 户 按键 时 ， 都 将 在 Pygame 中 注册 一 个 事件 。 事 件 都 是 通过 方法 pygame.event .get() 获 
取 的 ， 因 此 在 函数 check_events() 中 ， 我 们 需要 指定 要 检查 哪些 类 型 的 事件 。 每 次 按键 都 被 注册 
为 一 个 KEYDONN 事 件 。 

检测 到 KEYDOWN 事 件 时 ， 我 们 需要 检查 按 下 的 是 否 是 特定 的 键 。 例 如 ， 如 果 按 下 的 是 右 箭头 
键 ， 我 们 就 增 大 飞船 的 rect.centerx 值 ， 将 飞船 向 右 移动 : 


game_ functions.py 


def check 0 
”响应 按键 和 和 鼠标 事件 ” 
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for event in pygame.event.get() : 
if event.type == pygame.QUIT: 


sys.exit() 
© elif event.type == pygame.KEYDOWN: 
2 if event.key == pygame.K_RIGHT: 
# 向 右 移 动 飞船 
[3 ship.rect.centerx += 1 


我 们 在 函数 check_events() 中 包含 形 参 ship, 因为 玩家 按 右 箭 头 键 时 , 需要 将 飞船 向 右 移动 。 
在 函数 check_events() 内 部 ， 我 们 在 事件 循环 中 添加 了 一 个 elif 代 码 块 ， 以 便 在 Pygame 检测 到 
KEYDOM 事 件 时 作出 响应 〈 见 @ )。 我 们 读 取 属性 event.key ， 以 检查 按 下 的 是 否 是 右 箭头 键 
( pygame.K_RIGHT ) ( 见 @ )。 如 果 按 下 的 是 右 箭头 键 ， 就 将 ship.rect.centerx 的 值 加 1， 从 而 将 飞 
船 向 右 移 动 ( 见 @ )。 

在 alien_invasion.py 中 ,我 们 需要 更 新 调用 的 check_events() 代 码 , 将 ship 作 为 实 参 传递 给 它 : 


alien_invasion.py 


# 开始 游戏 主 循 环 
while True: 
gf.check events(ship) 
gf.update screen(ai settings, screen, ship) 


如 果 现 在 运行 alien_invasion.py， 则 每 按 右 箭头 键 一 次 ， 飞 船 都 将 向 右 移 动 1 像素 。 这 是 一 个 
开端 ， 但 并 非 控制 飞船 的 高 效 方式 。 下 面 来 改进 控制 方式 ， 人 允许 持续 移动 。 


12.6.2 ”允许 不 断 移 动 


玩家 按 住 右 箭头 键 不 放 时 ,我 们 希望 飞船 不 断 地 向 右 移动 ， 直 到 玩家 松 开 为 止 。 我们 将 让 游 
戏 检测 pygame.KEYUP 事 件 ， 以 便 玩 家 松 开 右 箭头 键 时 我 们 能 够 知道 这 一 点 ; 然后 ,我们 将 结合 使 
用 KEYDOWN 和 KEYUP 事 件 ， 以 及 一 个 名 为 moving right 的 标志 来 实现 持续 移动 。 

飞船 不 动 时 ， 标 志 moving right 将 为 False。 玩 家 按 下 右 箭 头 键 时 ， 我 们 将 这 个 标志 设置 为 
True; 而 玩家 松 开 时 ， 我 们 将 这 个 标志 重新 设置 为 False。 

飞船 的 属性 都 由 Ship 类 控制 ， 因 此 我 们 将 给 这 个 类 添加 一 个 名 为 noving_right 的 属性 和 一 个 
名 为 update() 的 方法 。 方 法 update() 检 查 标志 moving_right 的 状态 ， 如 果 这 个 标志 为 True， 就 调 
整 飞 船 的 位 置 。 每 当 需 要 调整 飞船 的 位 置 时 ， 我 们 都 调用 这 个 方法 。 

下 面 是 对 Ship 类 所 做 的 修改 : 


ship.py 


class Ship(): 


def init (self, screen): 
-- SNip-- 
# 将 每 艘 新 飞船 放 在 屏幕 底部 中 央 
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self.rect.centerx = self.screen rect.centerx 


self.rect.bottom = self.screen rect.bottom 
# 移动 标志 
@ self.moving right = False 


(2 def update(self): 
"" "根据 移动 标志 调整 飞船 的 位 置 """ 
if self.moving right: 
self.rect.centerx += 1 


def blitme(self): 


-- Snip-- 


在 方法 _init () 中 ,我 们 添加 了 属性 self.moving right, 并 将 其 初始 值 设 置 为 False( 见 @ )。 
接 下 来 ， 我 们 添加 了 方法 update()， 它 在 前 述 标志 为 True 时 癌 右 移动 飞船 ( 见 @ )。 

下 面 来 修改 check_events() ， 使 其 在 玩家 按 下 右 箭头 键 时 将 moving right 设置 为 True， 并 在 
玩家 松 开 时 将 moving right 设置 为 False: 


game functions.py 


def check events(ship): 
""" 响 应 按键 和 和 饼 标 事件 """ 
for event in pygame.event.get(): 
-- SN1ip-- 
elif event.type == pygame.KEYDOWN: 
if event.key == pygame.K_ RIGHT: 
@ ship.moving right = True 


@ elif event.type == pygame.KEYUP : 
if event.key == pygame.K_RIGHT: 
ship.moving right = False 


在 @ 处 ,我 们 修改 了 游戏 在 玩家 按 下 右 箭头 键 时 响应 的 方式 : 不 直接 调整 飞船 的 位 置 ， 而 只 
是 将 moving_right 设 置 为 True。 在 @ 处 ,我 们 添加 了 一 个 新 的 elif 代 码 块 ， 用 于 响应 KEYUP 事 件 : 
玩家 松 开 右 箭头 键 (K_RIGHT ) 时 ， 我 们 将 moving_right 设 置 为 False。 

最 后 ， 我 们 需要 修改 alien_invasion.py 中 的 while 循 环 ， 以 便 每 次 执行 循环 时 都 调用 飞船 的 
方法 update(): 


alien_invasion.py 


# 开始 游戏 主 循环 
while True : 
gf.check events(ship) 
ship.update() 
gf.update screen(ai settings, screen, ship) 


飞船 的 位 置 将 在 检测 到 键盘 事件 后 (但 在 更 新 屏幕 前 ) 更 新 。 这 样 ， 玩 家 输入 时 ， 飞 船 的 位 
置 将 更 新 ， 从 而 确保 使 用 更 新 后 的 位 置 将 飞船 绘制 到 屏幕 上 。 
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如 果 你 现在 运行 alien invasion.py 并 按 住 右 箭头 键 ,飞船 将 不 断 地 向 右 移动 ,直到 你 松 开 为 止 。 
12.6.3 ”左右 移动 
飞船 能 够 不 断 地 向 右 移 动 后 ， 添 加 向 左 移动 的 逻辑 很 容易 。 我 们 将 再 次 修改 ship 类 和 函数 


check _event 


s()。 下 面 显示 了 对 Ship 类 的 方法 _init () 和 update() 所 做 的 相关 修改 : 


ship.py 
def init (self, screen): 
-- Snip-- 
# 移动 标志 


人 
和 


self.moving right = False 
self.moving left = False 


update(self): 

"" "根据 移 动 标志 调整 飞船 的 位 置 """ 

if self.moving right: 
self.rect.centerx += 1 

if self.moving left: 
self.rect.centerx -= 1 


在 方法 _init () 中 , 我 们 添加 了 标志 self.moving le 人 ft; 在 方法 update() 中 , 我 们 添加 了 一 
个 if 代 码 块 而 不 是 elif 代 码 块 ， 这 样 如 果 玩 家 同时 按 下 了 左右 箭头 键 ， 将 先 增 大 飞船 的 
rect.centerx 值 ， 再 降低 这 个 值 ， 即 飞船 的 位 置 保持 不 变 。 如 果 使 用 一 个 elif 代 码 块 来 处 理 向 左 


移动 的 情况 ， 


右 第 头 键 将 始终 处 于 优先 地 位 。 从 向 左 移动 切换 到 向 右 移动 时 , 玩家 可 能 同时 按 住 


左右 箭头 键 ， 在 这 种 情况 下 ， 前 面 的 做 法 让 移动 更 准确 。 
我 们 还 需 对 check_events() 作 两 方面 的 调整 


game _ functions.py 


def chec 


k_events(ship) 


""" 响 应 按键 和 饼 标 事件 """ 


for 


event in pygame.event.get(): 
--SNnip-- 
elif event.type == pygame.KEYDOWN: 
if event.key == pygame.K_RIGHT: 
ship.moving right = True 
elif event.key == pygame.K_LEFT: 
ship.moving left = True 


elif event.type == pygame.KEYUP: 
if event.key == pygame.K_ RIGHT: 
ship.moving right = False 
elif event.key == pygame.K_LEFT: 
ship.moving left = False 


如 果 因 玩家 按 下 K_LEFT 键 而 触发 了 KEYDOWN 事 件 ， 我 们 就 将 moving left 设置 为 True; 如 果 因 
玩家 松 开 K_LEFT 而 触发 了 KEYUP 事 件 ， 我 们 就 将 moving left 设 置 为 False。 这 里 之 所 以 可 以 使 用 
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elif 代 码 块 ， 是 因为 每 个 事件 都 只 与 一 个 键 相 关联 ; 如 果 玩 家 同时 按 下 了 左右 箭头 键 ,将 检测 到 
两 个 不 同 的 事件 。 

如 果 此 时 运行 alien_invasion.py, 将 能 够 不 断 地 左右 移动 飞船 ;如 果 你 同时 按 左右 箭头 键 ， 飞 
船 将 纹 丝 不 动 。 

下 面 来 进一步 优化 飞船 的 移动 方式 : 调整 飞船 的 速度 ; 限制 飞船 的 移动 距离 ， 以 免 它 移 到 屏 
幕 外 面 去 。 


12.6.4 ”调整 飞船 的 速度 


当前 ， 每 次 执行 while 循 环 时 ， 飞 船 最 多 移动 1 像素 ， 但 我 们 可 以 在 Settings 类 中 添加 属性 
ship_speed factor, 用 于 控制 飞船 的 速度 。 我 们 将 根据 这 个 属性 决定 飞船 在 每 次 循环 时 最 多 移动 
多 少 距离 。 下 面 演 示 了 如 何在 settings.py 中 添加 这 个 新 属性 : 


settings.py 


class Settings(): 
一 个 存储 游戏 《外 星人 入 侵 》 的 所 有 设置 的 类 """ 


def init (self): 
-- Snip-- 


# 飞船 的 设置 
self.ship speed factor = 1.5 


我 们 将 ship_speed factor 的 初始 值 设置 成 了 1.5。 需 要 移动 飞船 时 ， 我 们 将 移动 1.5 像 素 而 不 
是 1 像素 。 

通过 将 速度 设置 指定 为 小 数值 , 可 在 后 面 加 快 游戏 的 节奏 时 更 细致 地 控制 飞船 的 速度 ,然而 ， 
rect 的 centerx 等 属性 只 能 存储 整数 值 ， 因 此 我 们 需要 对 Ship 类 做 些 修改 : 


ship.py 
class Ship(): 


© def —init _ (self, ai settings, screen): 
"初始 化 飞船 并 设置 其 初始 位 置 """ 
self.screen = screen 

@ self.ai settings = ai settings 
-Snip-- 


# 将 每 稻 新 飞船 放 在 屏幕 底部 中 央 
-= SNip-- 


# 在 飞船 的 属性 center 中 存储 小 数值 
(3 self.center = float(self.rect.centerx) 


# 移动 标志 
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self.moving right = False 
self.moving left = False 


de 


ls 


update(self): 
"" "根据 移动 标志 调整 飞船 的 位 置 """ 
# 更 新 飞船 的 center 值 ， 而 不 是 rect 
if self.moving right: 
@ self.center += self.ai settings.ship speed factor 
if self.moving left: 
self.center -= self.ai settings.ship speed factor 


# 根据 self.center 更 新 rect 对 象 
© self.rect.centerx = self.center 


def blitme(self): 
-- snip-- 


在 @ 处 , 我 们 在 _init () 的 形 参 列表 中 添加 了 ai_settings， 让 飞船 能 够 获取 其 速度 设置 。 


接 下 来 , 我们 将 形 参 ai_settings 的 值 存储 在 一 个 属性 中 ， 以 便 能 够 在 update() 中 使 用 它 ( 见 @ )。 
鉴于 现在 调整 飞船 的 位 置 时 , 将 增加 或 减 去 一 个 单位 为 像素 的 小 数值 , 因此 需要 将 位 置 存储 在 一 
个 能 够 存储 小 数值 的 变量 中 。 可 以 使 用 小 数 来 设置 rect 的 属性 , 但 rect 将 只 存储 这 个 值 的 整数 部 
分 。 为 准确 地 存储 飞船 的 位 置 ， 我 们 定义 了 一 个 可 存储 小 数值 的 新 属性 self.center ( 见 @ )。 我 


各 2 上 旧 


们 使 用 函数 float() 将 self.rect.centerx 的 值 转换 为 小 数 ， 并 将 结 

现在 在 update() 中 调整 飞船 的 位 置 时 ， 将 self.center 的 值 增加 或 减 去 ai settings.ship_ 
speed factor 的 值 ( 见 @ )。 更 新 self.center 后 ， 我 们 再 根据 它 来 更 新 控制 飞船 位 置 的 
self.rect.centerx ( 见 @ )，self.rect.centerx 将 只 存储 self.center 的 整数 部 分 ,但 对 显示 飞船 


而 言 ， 这 问题 不 大 。 


存储 到 self.center 中 。 


在 alien invasion.py 中 创建 Ship 实 例 时 ， 需 要 传人 实 参 ai settings: 


alien_invasion.py 


--SNip-- 
def run game(): 
-- Snip-- 
# 创建 飞船 
ship = Ship(ai settings, screen) 
-- Ship-- 


现在 ， 只 要 ship_speed_factor 的 值 大 于 1， 飞 船 的 移动 速度 就 会 比 以 前 更 快 。 这 有 助 于 让 飞 
船 的 反应 速度 足够 快 ， 能 够 将 外 星人 射 下 来 ， 还 让 我 们 能 够 随 着 游戏 的 进行 加 快 游戏 的 节奏 。 


12.6.5 ”限制 飞船 的 活动 范围 


当前 ， 如 果 玩 家 按 住 箭头 键 的 时 间 足 够 长 飞船 将 移 到 屏幕 外 面 ， 消 失 得 无 影 无 踪 。 下 面 来 
修复 这 种 问题 ， 让 飞船 到 达 屏 幕 边 缘 后 停止 移动 。 为 此 ， 我 们 将 修改 ship 类 的 方法 update(): 
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ship.py 


def update(self): 
"" "根据 移动 标志 调整 飞船 的 位 置 """ 
# 更 新 飞船 的 center 值 ， 而 不 是 rect 


© if self.moving right and self.rect.right «< self.screen rect.right: 
self.center += self.ai settings.ship speed factor 

© if self.moving left and self.rect.left > 0: 
self.center -= self.ai settings.ship speed factor 


# 根据 self.center 更 新 rect 对 象 
self.rect.centerx = self.center 


上 述 代 码 在 修改 self.center 的 值 之 前 检查 飞船 的 位 置 。self.rect.right 返 回 飞船 外 接 和 矩形 
的 右边 缘 的 x 坐标 ， 如 果 这 个 值 小 于 self.screen rect.right 的 值 ， 就 说 明 飞 船 未 触及 屏幕 右边 缘 
( 见 @ )。 左 边缘 的 情况 与 此 类 似 : 如 果 rect 的 左边 缘 的 x 坐 标 大 于 零 ， 就 说 明 飞 船 未 触及 屏幕 左 
边缘 ( 见 @ )。 这 确保 仅 当 飞船 在 屏幕 内 时 ， 才 调整 self.center 的 值 。 

如 果 此 时 运行 alien_invasion.py， 飞 船 将 在 触及 屏幕 左边 缘 或 右边 缘 后 停止 移动 。 


12.6.6” 重 构 check events() 


随 着 游戏 开发 的 进行 , 函数 check_events() 将 越 来 越 长 , 我 们 将 其 部 分 代码 放 在 两 个 函数 中 : 
一 个 处 理 KEYDOWN 事 件 ， 另 一 个 处 理 KEYUP 事 件 : 


game _functions.py 


def check keydown events(event, ship): 
""" 响 应 按键 """ 

if event.key == pygame.K_ RIGHT: 

ship.moving right = True 

elif event.key == pygame.K_LEFT: 

ship.moving left = True 


| 


def check keyup events(event, ship): 

"响应 松 开 """ 

if event.key == pygame.K_RIGHT: 

ship.moving right = False 

elif event.key == pygame.K_LEFT: 
ship.moving left = False 


def check events(ship) 
" "Wp 向 应 遍 
for event in pygame.event.get() : 
if event.type == pygame.QUIT: 
sys.exit() 
elif event.type == pygame.KEYDOWN: 
check_keydown events(event, ship) 
elif event.type == pygame.KEYUP: 
check_ keyup_events(event, ship) 
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我 们 创建 了 两 个 新 函数 : check_keydown_events() 和 check_keyup_events(), 它们 都 包含 形 参 
event 和 ship。 这 两 个 函数 的 代码 是 从 check_events() 中 复制 而 来 的 ,因此 我 们 将 函数 check_events 
中 相应 的 代码 替换 成 了 对 这 两 个 函数 的 调用 。 现 在 ， 函 数 check_events() 更 简单 ， 代 码 结构 更 清 
晰 。 这 样 ， 在 其 中 响应 其 他 玩家 输入 时 将 更 容易 。 


12.7 简单 回顾 
下 一 节 将 添加 射击 功能 , 这 需要 新 增 一 个 名 为 bullet.py 的 文件 , 并 对 一 些 既 有 文件 进行 修改 。 


当前 , 我 们 有 四 个 文件 ， 其 中 包含 很 多 类 、 函 数 和 方法 。 添 加 其 他 功能 之 前 ,为 让 你 清楚 这 个 项 
目的 组 织 结构 ， 先 来 回顾 一 下 这 些 文件 。 


12.7.1 alien_ invasion.py 


主 文件 alien_invasion.py 创 建 一 系列 整个 游戏 都 要 用 到 的 对 象 : 存储 在 ai_settings 中 的 设置 、 
存储 在 screen 中 的 主 显示 surface 以 及 一 个 飞船 实例 。 文 件 alien invasion.py 还 包含 游戏 的 主 循环 ， 
这 是 一 个 调用 check_events() 、ship.update() 和 update_screen() 的 while 循 环 。 

要 玩 游 戏 《 外 星人 入 侵 》， 只 需 运 行文 件 alien_ invasion.py。 其 他 文件 〈settings.py 、 
game_functions.py、ship.py ) 包含 的 代码 被 直接 或 间接 地 导入 到 这 个 文件 中 。 


12.7.2 settings.py 


文件 settings.py 包 含 Settings 类 ， 这 个 类 只 包含 方法 _init_()， 它 初始 化 控制 游戏 外 观 和 飞 
船 速 度 的 属性 。 


12.7.3 game functions.py 


文件 game_functions.py 包 含 一 系列 函数 ， 游 戏 的 大 部 分 工作 都 是 由 它们 完成 的 。 函 数 
check_events() 检 测 相 关 的 事件 ， 如 按键 和 松 开 ， 并 使 用 辅助 函数 check keydown_events() 和 
check keyup_events() 来 处 理 这 些 事 件 。 就 目前 而 言 ， 这 些 函 数 管 理 飞 船 的 移动 。 模 块 
game_functions 还 包含 函数 update_screen() ， 它 用 于 在 每 次 执行 主 循环 时 都 重 绘 屏幕 。 


12.7.4 ship.py 


文件 ship.py 包 含 ship 类 ， 这 个 类 包含 方法 init ()、 管 理 飞 船 位 置 的 方法 update() 以 及 在 
屏幕 上 绘制 飞船 的 方法 blitme()。 表 示 飞 船 的 图 像 存 储 在 文件 夹 images 下 的 文件 ship.bmp 中 。 


动手 试 一 斌 


12-3 火箭 : 编写 一 个 游戏 ， 开 始 时 屏幕 中 央 有 一 个 火箭 ， 而 玩家 本 使 用 四 个 方向 
键 上 下 左右 移动 火箭 。 请 务必 确保 火箭 不 会 移 到 屏幕 外 面 。 


224 第 12 章 武装 飞船 


12-4 按键 : 创建 一 个 程序 ， 显示 一 个 空 屏幕 。 在 事件 循环 中 ， 每 当 检 测 到 
pygame .KEYDOWN 事件 时 都 打印 属性 event .key。 运 行 这 个 程序 , 并 按 各 种 键 , 看 看 Pygame 
如 何 响应 。 


12.8 射击 


下 面 来 添加 射击 功能 。 我 们 将 编写 玩家 按 空格 键 时 发 射 子弹 (小 矩形 ) 的 代码 。 子 弹 将 在 屏 
幕 中 向 上 穿行 ， 抵 达 屏幕 上 边缘 后 消失 。 


12.8.1 添加 子弹 设置 


首先 ， 更 新 settings.py， 在 其 方法 ”init () 末 尾 存 储 新 类 Bullet 所 需 的 值 : 
settings.py 


def init (self) 
-- SN1p-- 
# 子弹 设置 
self.bullet speed factor = 1 
self.bullet width = 3 
self.bullet height = 15 
self.bullet color = 60, 60, 60 


这 些 设置 创建 宽 3 像 素 、 高 15 像 素 的 深 灰 色 子 弹 。 子 弹 的 速度 比 飞船 稍 低 。 


12.8.2 ”创建 Bullet 类 


下 面 来 创建 存储 Bullet 类 的 文件 bulletpy， 其 前 半 部 分 如 下 : 
bullet.py 


import pygame 
from pygame.sprite import Sprite 


class Bullet(Sprite): 
""" 一 个 对 飞船 发 射 的 子弹 进行 管理 的 类 """ 


def init (self, ai settings, screen, ship): 
""" 在 飞船 所 处 的 位 置 创建 一 个 子弹 对 象 """ 
super(Bullet, self). init () 


self.screen = screen 


# 在 (0,0) 处 创建 一 个 表示 子弹 的 给 形 ， 再 设置 正确 的 位 置 

© self.rect = pygame.Rect(0, 0, ai settings.bullet width, 
ai settings.bullet height) 

self.rect.centerx = ship.rect.centerx 

self.rect.top = ship.rect.top 


©O® 
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# 存 储 用 小 数 表 示 的 子弹 位 置 
9 self.y = float(self.rect.y) 


© self.color = ai settings.bullet color 
self.speed factor = ai settings.bullet speed factor 


Bullet 类 继承 了 我 们 从 模块 pygame.sprite 中 导入 的 Sprite 类 。 通 过 使 用 精 录 ， 可 将 游戏 中 相 
关 的 元 素 编组 ， 进 而 同时 操作 编组 中 的 所 有 元 素 。 为 创建 子弹 实例 ， 需 要 向 _init () 传 递 
ai settings 、screen 和 ship 实 例 ， 还 调用 了 super() 来 继承 Sprite。 


注意 ”代码 super(Bullet, self). init () 使 用 了 Python 2.7 语 法 。 这 种 语法 也 适用 于 Python 3， 
但 你 也 可 以 将 这 行 代码 简写 为 super(). init ()。 


在 @ 处 ,我们 创建 了 子弹 的 属性 rect。 子 弹 并 非 基于 图 像 的 , 因此 我 们 必须 使 用 pygame .Rect() 
类 从 空白 开始 创建 一 个 和 矩形。 创建 这 个 类 的 实例 时 ， 必 须 提供 矩形 左上 角 的 x 坐 标 和 ?坐标 ， 还 有 
和 矩形 的 宽度 和 高 度 。 我 们 在 (0, 0) 处 创建 这 个 矩形 ， 但 接 下 来 的 两 行 代码 将 其 移 到 了 正确 的 位 置 ， 
因为 子弹 的 初始 位 置 取决 于 飞船 当前 的 位 置 。 子 弹 的 宽度 和 高 度 是 从 ai_settings 中 获取 的 。 

在 @ 处 ,我 们 将 子弹 的 centerx 设 置 为 飞船 的 rect.centerx。 子 弹 应 从 飞船 项 部 射出 ， 因 此 我 
们 将 表示 子弹 的 rect 的 top 属 性 设置 为 飞船 的 rect 的 top 属 性 ， 让 子弹 看 起 来 像 是 从 飞船 中 射出 的 
( 见 @ )。 

我 们 将 子弹 的 ?坐标 存储 为 小 数值 ， 以 便 能 够 微调 子弹 的 速度 ( 见 @ )。 在 @ 处 ,我 们 将 子弹 
的 颜色 和 速度 设置 分 别 存 储 到 self.color 和 self.speed factor 中。 

下 面 是 bullet.py 的 第 二 部 分 一 一 方法 update() 和 draw bullet(): 


bullet.py 


def update(self) : 
""" 向 上 移动 子弹 """ 
# 更 新 表示 子弹 位 置 的 小 数值 
© self.y -= self.speed factor 
# 更 新 表示 子弹 的 rect 的 位 置 
2 self.rect.y = self.y 


def draw bullet(self): 
""" 在 屏幕 上 绘制 子弹 """ 


(3 pygame.draw.rect(self.screen, self.color, self.rect) 


方法 update() 管 理子 弹 的 位 置 。 发 射出 去 后 ， 子 弹 在 屏幕 中 和 同上 移动 ， 这 意味 着 ) 坐 标 将 不 
断 减 小 ， 因 此 为 更 新 子弹 的 位 置 ， 我 们 从 self.y 中 减 去 self.speed _ factor 的 值 ( 见 @ )。 接 下 来 ， 
我 们 将 self.rect.y 设 置 为 self.y 的 值 ( 见 @ )。 属性 speed_factor 让 我 们 能 够 随 着 游戏 的 进行 或 根 
据 需 要 提高 子弹 的 速度 ， 以 调整 游戏 的 行为 。 子 弹 发 射 后 ， 其 x 坐标 始终 不 变 ， 因 此 子弹 将 沿 直 
线 垂直 地 往 上 穿行 。 
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需要 绘制 子弹 时 , 我 们 调用 draw_bullet()。 函数 draw.rect() 使 用 存储 在 self.color 中 的 颜色 
填充 表示 子弹 的 rect 占 据 的 屏幕 部 分 ( 见 @ )。 


12.8.3 ”将 子弹 存储 到 编组 中 


定义 Bullet 类 和 必要 的 设置 后 , 就 可 以 编写 代码 了 , 在 玩家 每 次 按 空 格 键 时 都 射出 一 发 子弹 。 
首先 ， 我 们 将 在 alien_invasion.py 中 创建 一 个 编组 ( group )， 用 于 存储 所 有 有 效 的 子弹 ， 以 便 能 够 
管理 发 射出 去 的 所 有 子弹 。 这 个 编组 将 是 pygame.sprite.Group 类 的 一 个 实例 ; pygame.sprite. 
Group 类 类 似 于 列表 ， 但 提供 了 有 助 于 开发 游戏 的 额外 功能 。 在 主 循环 中 ， 我 们 将 使 用 这 个 编组 
在 屏幕 上 绘制 子弹 ， 以 及 更 新 每 颗 子弹 的 位 置 : 


alien_invasion.py 


import pygame 
from pygame.sprite import Group 
-- Snip-- 


def run game(): 
-- Snip-- 
# 创建 一 般 飞 船 
ship = Ship(ai settings, screen) 
# 创建 一 个 用 于 存储 子弹 的 编组 
© bullets = Group() 


# 开始 游戏 主 循环 
while True: 
gf.check events(ai settings, screen, ship, bullets) 
ship.update() 
29 bullets.update() 
gf.update screen(ai settings, screen, ship, bullets) 


run_game() 


我 们 导入 了 pygame.sprite 中 的 Group 类 。 在 @ 处 ， 我 们 创建 了 一 个 Group 实例 ， 并 将 其 命名 为 
bullets。 这 个 编组 是 在 while 循 环 外 面 创 建 的 ， 这 样 就 无 需 每 次 运行 该 循环 时 都 创建 一 个 新 的 子 
弹 编 组 。 


注意 ”如 果 在 循环 内 部 创建 这 样 的 编组 ， 游 戏 运行 时 将 创建 数 千 个 子弹 编组 ， 导 致 游戏 慢 得 像 
蜗牛 。 如 果 游 戏 停滞 不 前 ， 请 仔细 查看 主 While 循 环 中 发 生 的 情况 。 


我 们 将 bullets 传 递 给 了 check_events() 和 update screen()。 在 check_events() 中 ,需要 在 玩 
家 按 空格 键 时 处 理 bullets; 而 在 update_screen() 中 ,需要 更 新 要 绘制 到 屏幕 上 的 bullets。 

当 你 对 编组 调用 update() 时 ， 编 组 将 自动 对 其 中 的 每 个 精灵 调用 update()， 因 此 代码 行 
bullets.update() 将 为 编组 bullets 中 的 每 颗 子 弹 调 用 bullet.update()。 
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12.8. 


4 开火 


在 game_functions.py 中 , 我 们 需要 修改 check_keydown_events(), 以 便 在 玩家 按 空格 键 时 发 射 
一 颗 子弹 。 我 们 无 需 修 改 check keyup_events() ， 因 为 玩家 松 开 空格 键 时 什么 都 不 会 发 生 。 我 们 
还 需 修 改 update_screen() ， 确 保 在 调用 flip() 前 在 屏幕 上 重 绘 每 颗 子 弹 。 下 面 是 对 game_ 
functions.py 所 做 的 相关 修改 : 


game _ functions.py 


-Snip-- 


from bullet import Bullet 


@ def check keydown events(event, ai settings, screen, ship, bullets): 


© 


-- Snip-- 
elif event.key == pygame.K_SPACE: 
# 创建 一 颗 子 弹 ， 并 将 其 加 入 到 编组 bullets 中 
new bullet = Bullet(ai settings, screen, ship) 
bullets.add(new bullet) 
-- Snip-- 


@ def check events(ai settings, screen, ship, bullets): 


"" "响应 按键 和 和 饼 标 事件 """ 
for event in pygame.event.get(): 
--SNnip-- 
elif event.type == pygame.KEYDOWN: 
check_ keydown events(event, ai settings, screen, ship, bullets) 
-- SNnip-- 


@ def update screen(ai settings, screen, ship, bullets): 


© 


-- Snip-- 

# 在 飞船 和 外 星人 后 面 重 绘 所 有 子弹 

for bullet in bullets.sprites(): 
bullet.draw bullet() 

ship.blitme() 

-- Snip-- 


编组 bulltes 传 递 给 了 check keydown_events()( 见 @ )。 玩家 按 空 格 键 时 , 创建 一 颗 新 子弹 ( 


个 名 为 new_bullet 的 Bullet 实 例 )， 并 使 用 方法 add() 将 其 加 入 到 编组 bullets 中 ( 见 四 ); 代码 


bullet 


ts.add(new_bullet) 将 新 子弹 存储 到 编组 pullets 中 。 


在 check_events() 的 定义 中 ,我 们 需要 添加 形 参 bullets( 见 @ ); 调用 check_keydown events() 


时 ,我 们 也 需要 将 bullets 作 为 实 参 传递 给 它 。 


bullet 


在 @ 处 ,我 们 给 在 屏幕 上 绘制 子弹 的 update screen() 添加 了 形 参 bullets 。 方 法 


ts.spirites() 返 回 一 个 列表 ， 其 中 包含 编组 bullets 中 的 所 有 精灵 。 为 在 屏幕 上 绘制 发 射 的 


所 有 子弹 ， 我 们 遍历 编组 bullets 中 的 精灵 ， 并 对 每 个 精灵 都 调用 draw_ pullet() ( 见 @ )。 


妇 


[ 果 此 时 运行 alien_invasion.py， 将 能 够 左右 移动 飞船 ， 并 发 射 任意 数量 的 子弹 。 子 弹 在 屏 


幕 上 向 上 穿行 , 抵达 屏幕 项 部 后 消失 ， 如 图 12-3 所 示 。 可 在 settings.py 中 修改 子弹 的 尺寸 、 颜色 和 


速度 。 


全 


图 12-3 飞船 发 射 一 系列 子弹 后 的 《外 星人 入 侵 》 游 戏 


12.8.5 ”删除 已 消失 的 子弹 

当前 ， 子 弹 抵 达 屏 幕 顶端 后 消失 ， 这 仅仅 是 因为 Pygame 无 法 在 屏幕 外 面 绘制 它们 。 这 些 子 
弹 实际 上 依然 存在 ， 它 们 的 y 坐 标 为 负数 ， 且 越 来 越 小 。 这 是 个 问题 ， 因 为 它们 将 继续 消耗 内 存 
和 处 理 能 力 。 

我 们 需要 将 这 些 已 消失 的 子弹 删除 ， 否则 游戏 所 做 的 无 谓 工作 将 越 来 越 多 , 进而 变 得 越 来 越 
慢 。 为 此 ， 我们 需要 检测 这 样 的 条 件 ， 即 表示 子弹 的 rect 的 bottom 属 性 为 零 ， 它 表明 子弹 已 穿 过 
屏幕 顶端 : 


alien_invasion.py 


hip, bullets) 


ts( settings, screen, s 


s €) 
bullets.update() 


# 删除 已 消失 的 子弹 
for bullet in bullets.copy(): 
if bullet.rect.bottom <= 0: 
bullets.remove(bullet) 
print(len(bullets)) 


OO 


gf.update screen(ai settings, screen, ship, bullets) 


12.8 ”射击 229 


在 for 循 环 中 ， 不 应 从 列表 或 编组 中 删除 条 目 ， 因 此 必须 遍历 编组 的 副本 。 我 们 使 用 了 方法 
copy() 来 设置 for 循 环 ( 见 @ ), 这 让 我 们 能 够 在 循环 中 修改 bullets。 我 们 检查 每 颗 子 弹 , 看 看 它 
是 否 已 从 屏幕 顶端 消失 ( 见 @ )。 如 果 是 这 样 ， 就 将 其 从 bullets 中 删除 ( 见 @ ),。 在 @ 处 , 我 们 使 
用 了 一 条 print 语 句 ， 以 显示 当前 还 有 多 少 颗 子弹 ， 从 而 核实 已 消失 的 子弹 确实 删除 了 。 

如 果 这 些 代码 没有 问题 , 我 们 发 射 子弹 后 查看 终端 窗口 时 , 将 发 现 随 着 子弹 一 颗 颗 地 在 屏幕 
顶端 消失 ,子弹 数 将 逐渐 降 为 零 。 运 行 这 个 游戏 并 确认 子弹 已 被 删除 后 ,将 这 条 print 语 句 删 除 。 
如 果 你 留 下 这 条 语句 , 游戏 的 速度 将 大 大 降低 ,因为 将 输出 写 入 到 终端 而 花费 的 时 间 比 将 图 形 绘 
制 到 游戏 窗口 花费 的 时 间 还 多 。 


12.8.6 ”限制 子弹 数量 


很 多 射击 游戏 都 对 可 同时 出 现在 屏幕 上 的 子弹 数量 进行 限制 ,以 鼓励 玩家 有 目标 地 射击 。 下 
面 在 游戏 《外 星人 入 侵 》 中 作 这 样 的 限制 。 
首先 ， 在 settings.py 中 存储 所 允许 的 最 大 子弹 数 : 


settings.py 


# 子弹 设置 

self.bullet width = 3 
self.bullet height = 15 
self.bullet color = 60，60，60 
self.bullets allowed = 3 


这 将 未 消失 的 子弹 数 限制 为 3 颗 。 在 game_functions.py 的 check_keydown_events() 中 ， 我 们 在 
创建 新 子弹 前 检查 未 消失 的 子弹 数 是 否 小 于 该 设置 : 


game_functions.py 


def check keydown events(event, ai settings, screen, ship, bullets): 
-- Snip-- 
elif event.key == pygame.K_SPACE: 
# 创建 新 子弹 并 将 其 加 入 到 编组 bullets 中 
if len(bullets) < ai settings.bullets allowed: 
new bullet = Bullet(ai settings, screen, ship) 
bullets.add(new bullet) 


玩家 按 空格 键 时 ， 我 们 检查 bullets 的 长 度 。 如 果 len(bullets) 小 于 3 ， 我 们 就 创建 一 个 新 子 
弹 ; 但 如 果 已 有 3 颗 未 消失 的 子弹 ， 则 玩家 按 空格 键 时 什么 都 不 会 发 生 。 如 果 你 现在 运行 这 个 游 
戏 ， 屏 幕 上 最 多 只 能 有 3 颗 子 弹 。 


12.8.7 ”创建 函数 update bullets() 


编写 并 检查 子弹 管理 代码 后 ， 可 将 其 移 到 模块 game functions 中 ， 以 让 主 程序 文件 
alien_invasion.py 尽 可 能 简单 。 我 们 创建 一 个 名 为 update_bullets() 的 新 函数 ， 并 将 其 添加 到 
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game_functions.py 的 末尾 : 


game _ functions.py 


def update bullets(bullets): 
""" 更 新 子弹 的 位 置 ， 并 删除 已 消失 的 子弹 """ 
# 更 新 子弹 的 位 置 
bullets.update() 


# 删除 已 消失 的 子弹 
for bullet in bullets.copy(): 
if bullet.rect.bottom <= 0: 
bullets.remove(bullet) 


update_ bullets() 的 代码 是 从 alien_invasion.py 剪 切 并 粘贴 而 来 的 , 它 只 需要 一 个 参数 ， 即 编 
组 bullets。 
alien invasion.py 中 的 while 循 环 又 变 得 很 简单 了 : 


alien invasion.py 


N 


# 开始 游戏 主 循环 
while True : 
gf.check events(ai settings, screen, ship, bullets) 
ship.update() 
gf.update bullets(bullets) 
gf.update screen(ai settings, screen, ship, bullets) 


OO@OO® 


我 们 让 主 循环 包含 尽 可 能 少 的 代码 , 这 样 只 要 看 函数 名 就 能 迅速 知道 游戏 中 发 生 的 情况 。 主 
循环 检查 玩家 的 输入 ( 见 @ ), 然后 更 新 飞船 的 位 置 ( 见 @ ) 和 所 有 未 消失 的 子弹 的 位 置 ( 见 @ )。 
接 下 来 ， 我们 使 用 更 新 后 的 位 置 来 绘制 新 屏幕 ( 见 @ )。 


12.8.8 创建 函数 fire bullet() 


下 面 将 发 射 子弹 的 代码 移 到 一 个 独立 的 函数 中 ， 这 样 ， 在 check_keydown_events() 中 内 需 使 
一 行 代码 来 发 射 子弹 ， 让 elif 代 码 块 变 得 非常 简单 : 


game _functions.py 


def check keydown events(event, ai settings, screen, ship, bullets): 
"响应 按键 """ 
-- SNip-- 
elif event.key == pygame.K_SPACE : 
fire bullet(ai settings, screen, ship, bullets) 


def fire bullet(ai settings, screen, ship, bullets): 
""" 如 果 还 没有 到 达 限制 ， 就 发 射 一 颗 子 弹 """ 

# 创 建新 子弹 ， 并 将 其 加 入 到 编组 bullets 中 

if len(bullets) < ai settings.bullets allowed: 
new bullet = Bullet(ai settings, screen, ship) 
bullets.add(new bullet) 
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函数 fire_ bullet() 只 包含 玩家 按 空格 键 时 用 于 发 射 子弹 的 代码 ; 在 check keydown_events() 
中 ， 我 们 在 玩家 按 空格 键 时 调用 fire_bullet()。 
请 再 次 运行 alien_invasion.py， 确认 发 射 子弹 时 依然 没有 错误 。 


动手 试 一 斌 
12-5 侧面 射击 : 编写 一 个 游戏 ， 将 一 稻 飞 船 放 在 屏幕 左边 ， 并 允许 玩家 上 下 移动 


飞船 。 在 玩家 按 空格 键 时 ,让 飞船 发 射 一 颗 在 屏幕 中 向 右 穿行 的 子弹 ， 并 在 子弹 离开 屏 
幕 而 消失 后 将 其 删除 。 


12.9 ”小结 


在 本 章 中 ,你 学 习 了 : 游戏 开发 计划 的 制定 ; 使 用 Pygame 编 写 的 游戏 的 基本 结构 ; 如 何 设 
置 背景 色 , 以 及 如 何 将 设置 存储 在 可 供 游戏 的 各 个 部 分 访问 的 独立 类 中 ; 如 何在 屏幕 上 绘制 图 像 ， 
以 及 如 何 让 玩家 控制 游戏 元 素 的 移动 ; 如 何 创建 自动 移动 的 元 素 ， 如 在 屏幕 中 向 上 飞驰 的 子弹 ， 
以 及 如 何 删除 不 再 需要 的 对 象 ; 如 何 定期 重 构 项 目的 代码 ， 为 后 续 开 发 提供 便利 。 

在 第 13 章 中 , 我 们 将 在 游戏 《外 星人 入 侵 》 中 添加 外 星人 。 在 第 13 章 结束 时 ， 你 将 能 够 击落 
外 星人 一 一 但 愿 是 在 他 们 撞 到 飞船 前 ! 


外 星人 


在 本 章 中 ， 我 们 将 在 游戏 《外 星人 入 侵 》 中 添加 外 星人 。 首 先 ， 
我 们 在 屏幕 上 边缘 附近 添加 一 个 外 星人 ，, 然后 生成 一 群 外 星人 。 我 们 
让 这 群 外 星人 向 两 边 和 下 面 移动 ,并 删除 被 子弹 击 中 的 外 星人 ,最 后 ， 
我 们 将 显示 玩家 拥有 的 飞船 数量 ， 并 在 玩家 的 飞船 用 完 后 结束 游戏 。 

通过 阅读 本 章 ， 你 将 更 深入 地 了 解 Pygame 和 大 型 项 目的 管理 。 
你 还 将 学 习 如 何 检测 游戏 对 象 之 间 的 碰撞 ,如 子弹 和 外 星人 之 间 的 碰 
撞 。 检测 碰撞 有 助 于 你 定义 游戏 元 素 之 间 的 交互 ; 可 以 将 角色 限定 在 
迷宫 墙壁 之 内 或 在 两 个 角色 之 间 传 球 ,我 们 将 时 不 时 地 查看 游戏 开发 
计划 ， 以 确保 编程 工作 不 偏离 轨道 。 

着 手 编写 在 屏幕 上 添加 一 群 外 星人 的 代码 前 , 先 来 回顾 一 下 这 个 项 目 , 并 更 新 开发 计划 。 


13.1 ”回顾 项 目 


开发 较 大 的 项 目 时 , 进入 每 个 开发 阶段 前 回顾 一 下 开发 计划 , 搞 清楚 接 下 来 要 通过 编写 代码 
来 完成 哪些 任务 都 是 不 错 的 主意 。 本 章 涉及 以 下 内 容 。 
口 研究 既 有 代码 ， 确 定 实现 新 功能 前 是 否 要 进行 重 构 。 
口 在 屏幕 左上 角 添 加 一 个 外 星人 ， 并 指定 合适 的 边 距 。 
口 根据 第 一 个 外 星人 的 边 距 和 屏幕 尺寸 计算 屏幕 上 可 容纳 多 少 个 外 星人 。 我 们 将 编写 一 个 
循环 来 创建 一 系列 外 星人 ， 这 些 外 星人 填 满 了 屏幕 的 上 半 部 分 。 
口 让 外 星人 和 群 向 两 边 和 下 方 移动 ， 直 到 外 星人 被 全 部 击落 ， 有 外 星人 撞 到 飞船 ， 或 有 外 星 

人 抵达 屏幕 底 端 。 如 果 整 群 外 星人 都 被 击落 ， 我 们 将 再 创建 一 群 外 星人 。 如 果 有 外 星人 

撞 到 了 飞船 或 抵达 屏幕 底 端 ， 我 们 将 销毁 飞船 并 再 创建 一 群 外 星人 。 

口 限制 玩家 可 用 的 飞船 数量 ， 配 给 的 飞船 用 完 后 ， 游 戏 结束 。 

我 们 将 在 实现 功能 的 同时 完善 这 个 计划 ,但 就 目前 而 言 ， 该 计划 已 足够 详尽 。 

在 给 项 目 添加 新 功能 前 ,还 应 审核 既 有 代码 。 每 进入 一 个 新 阶段 , 通常 项 目 都 会 更 复杂 ， 因 
此 最 好 对 混乱 或 低 效 的 代码 进行 清理 。 

我 们 在 开发 的 同时 一 直 不 断 地 重 构 , 因此 当前 需要 做 的 清理 工作 不 多 , 但 每 次 为 测试 新 功能 
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运行 这 个 游戏 时 ， 都 必须 使 用 鼠标 来 关闭 它 ， 这 太 讨 大 了。 下 面 来 添加 一 个 结束 游戏 的 快捷 键 Q: 


game _functions.py 


def check keydown events(event, ai settings, screen, ship, bullets): 
-- Snip-- 
elif event.key == pygame.K_q: 
sys.exit() 


在 check_keydown_events() 中 ， 我 们 添加 了 一 个 代码 块 ， 以 便 在 玩家 按 Q 时 结束 游戏 。 这 样 
的 修改 很 安全 ， 因 为 Q 键 离 箭头 键 和 空格 键 很 远 ， 玩 家 不 小 心 按 Q 键 而 导致 游戏 结束 的 可 能 性 不 
大 。 现 在 测试 时 可 按 Q 关 闭 游 戏 ， 而 无 需 使 用 鼠标 来 关闭 窗口 了 。 


13.2 ”创建 第 一 个 外 星人 


在 屏幕 上 放置 外 星人 与 放置 飞船 类 似 。 每 个 外 星人 的 行为 都 由 Alien 类 控制 ， 我 们 将 像 创 建 
Ship 类 那样 创建 这 个 类 。 出 于 简化 考虑 ,我 们 也 使 用 位 图 来 表示 外 星人 。 你 可 以 自己 寻找 表示 外 
星人 的 图 像 ， 也 可 使 用 图 13-1 所 示 的 图 像 ， 可 在 本 书 配套 资源 ( https:/www.nostarch.com/ 
pythoncrashcourse/ ) 中 找到 。 这 幅 图 像 的 背景 为 灰色 ， 与 屏幕 背景 色 一 致 。 请 务必 将 你 选择 的 
像 文件 保存 到 文件 夹 images 中 。 


了 


图 13-1 用 来 创建 外 星人 群 的 外 星人 图 像 


13.2.1 创建 Alien 类 
下 面 来 编写 Alien 类 : 


alien.py 


import pygame 
from pygame.sprite import Sprite 
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class Alien(Sprite): 
"" "表示 单个 外 星人 的 类 """ 


def init (self, ai settings, screen): 
""" 初 始 化 外 星人 并 设置 其 起 始 位 置 """ 
super(Alien, self). init () 
self.screen = screen 
self.ai settings = ai settings 


# 加 载 外 星人 图 像 ， 并 设置 其 rect 属 性 
self.image = pygame.image.load('images/alien.bmp') 
self.rect = self.image.get rect() 


# 每 个 外 星人 最 初 都 在 屏幕 左上 角 附 近 
© self.rect.x = self.rect.width 
self.rect.y = self.rect.height 


# 存储 外 星人 的 准确 位 置 
self.x = float(self.rect.x 


def blitme(self): 
""" 在 指定 位 置 绘 制 外 星人 """ 
self.screen.blit(self.image, self.rect) 
除 位 置 不 同 外 ， 这 个 类 的 大 部 分 代码 都 与 ship 类 相似 。 每 个 外 星人 最 初 都 位 于 屏幕 左上 
角 附 近 ， 我 们 将 每 个 外 星人 的 左边 距 都 设置 为 外 星人 的 宽度 ， 并 将 上 边 距 设置 为 外 星人 的 高 
度 ( 见 @ )。 


13.2.2 ”创建 Alien 实例 


下 面 在 alien invasion.py 中 创建 一 个 Alien 实 例 : 
alien_invasion.py 


-- Shnip-- 

from ship import Ship 

from alien import Alien 
import game functions as gf 


def run game(): 
-- Snip-- 
# 创建 一 个 外 星人 
alien = Alien(ai settings, screen) 


# 开始 游戏 主 循环 
while True: 
gf.check events(ai settings, screen, ship, bullets) 
ship.update() 
gf.update bullets(bullets) 
gf.update screen(ai settings, screen, ship, alien, bullets) 


run game() 
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在 这 里 , 我 们 导入 了 新 创建 的 Alien 类 , 并 在 进入 主 while 循 环 前 创建 了 一 个 Alien 实 例 。 我 们 
没有 修改 外 星人 的 位 置 ， 因 此 该 while 循 环 没 有 任何 新 东西 ， 但 我 们 修改 了 对 update_screen() 的 
调用 ,传递 了 一 个 外 星人 实例 。 

13.2.3 ”让 外 星人 出 现在 屏幕 上 
为 让 外 星人 出 现在 屏幕 上 ， 我 们 在 update_screen() 中 调用 其 方法 blitme(): 


game _ functions.py 


def update screen(ai settings, screen, ship, alien, bullets): 


a SNnip- _ 


# 在 飞船 和 外 星人 后 面 重 绘 所 有 的 子弹 
for bullet in bullets: 

bullet.draw bullet() 
ship.blitme() 
alien.blitme() 


# 让 最 近 绘 制 的 屏幕 可 见 


pygame.display.flip() 
我 们 先 绘制 飞船 和 子弹 ,再 绘制 外 星人 ,让 外 星人 在 屏幕 上 位 于 最 前 面 。 图 13-2 显 示 了 屏幕 
上 的 第 一 个 外 星人 。 


会 
图 13-2 ”第 一 个 外 星人 现 身 


第 一 个 外 星人 正确 地 现 身 后 ， 下 面 来 编写 绘制 一 群 外 星人 的 代码 。 
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13.3 创建 一 群 外 星人 


要 绘制 一 群 外 星人 , 需要 确定 一 行 能 容纳 多 少 个 外 星人 以 及 要 绘制 多 少 行 外 星人 。 我 们 将 首 
先 计 算 外 星人 之 间 的 水 平 间 距 , 并 创建 一 行 外 星人 , 再 确定 可 用 的 垂直 空间 , 并 创建 整 群 外 星人 。 


13.3.1 确定 一 行 可 容纳 多 少 个 外 星人 

为 确定 一 行 可 容纳 多 少 个 外 星人 ， 我 们 来 看 看 可 用 的 水 平 空间 有 和 多大。 屏幕 宽度 存储 在 
ai_settings.screen_width 中 , 但 需要 在 屏幕 两 边 都 留 下 一 定 的 边 距 ,把 它 设置 为 外 星人 的 宽度 。 
由 于 有 两 个 边 距 ， 因 此 可 用 于 放置 外 星人 的 水 平 空间 为 屏幕 宽度 减 去 外 星人 宽度 的 两 倍 : 


available space x = ai settings.screen width - (2 * alien width) 


我 们 还 需要 在 外 星人 之 间 留 出 一 定 的 空间 ， 即 外 星人 宽度 。 因 此 , 显示 一 个 外 星人 所 需 的 水 
平 空 间 为 外 星人 宽度 的 两 倍 : 一 个 宽度 用 于 放置 外 星人 ， 男 一 个 宽度 为 外 星人 右边 的 空白 区 域 。 
为 确定 一 行 可 容纳 多 少 个 外 星人 ， 我 们 将 可 用 空间 除 以 外 星人 宽度 的 两 倍 : 


number aliens x = available space x / (2 * alien width) 


我 们 将 在 创建 外 星人 群 时 使 用 这 些 公式 。 


注意 令 人 欣慰 的 是 ， 在 程序 中 执行 计算 时 ， 一 开始 你 无 需 确定 公式 是 正确 的 ， 而 可 以 尝试 直 
接 运行 程序 ， 看 看 结果 是 否 符 合 预 期 。 即 便 是 在 最 糟糕 的 情况 下 ， 也 只 是 屏幕 上 显示 的 
外 星人 太 多 或 太 少 。 你 可 以 根据 在 屏幕 上 看 到 的 情况 调整 计算 公式 。 


13.3.2 ”创建 多 行 外 星人 


为 创建 一 行 外 星人 ,首先 在 alien invasion.py 中 创建 一 个 名 为 aliens 的 空 编组 ， 用 于 存储 全 部 
外 星人 ， 再 调用 game_functions.py 中 创建 外 星人 和 群 的 函数 ; 


alien invasion.py 


import pygame 

from pygame.sprite import Group 
from settings import Settings 
from ship import Ship 

import game functions as gf 


def run game(): 
-- Snip-- 
# 创建 一 艘 飞船、 一 个 子弹 编组 和 一 个 外 星人 编组 
ship = Ship(ai settings, screen) 
bullets = Group() 
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@ aliens = Group() 


# 创建 外 星人 群 
@ gf.create fleet(ai settings, screen, aliens) 


# 开始 游戏 主 循环 
while True: 
--5717T/- 
3 gf.update screen(ai settings, screen, ship, aliens, bullets) 


run_game() 


由 于 我 们 不 再 在 alien_invasion.py 中 直接 创建 外 星人 ， 因此 无 需 在 这 个 文件 中 导入 Alien 类 。 

@ 处 创建 了 一 个 空 编 组 ， 用 于 存储 所 有 的 外 星人 。 接 下 来 ， 调 用 稍 后 将 编写 的 函数 
create fleet()( 见 @)， 着 将 _settings 、 对 象 screen 和 空 编 组 aliens 传 递 给 它 。 然 后 ,修改 对 
update_screen() 的 调用 ， 让 它 能 够 访问 外 星人 编组 ( 见 @ )。 

我 们 还 i screen(): 


game _functions.py 


def update screen(ai settings, screen, ship, aliens, bullets): 
-- Snip-- 
ship.blitme() 
aliens.draw(screen) 


# 让 最 近 绘 制 的 屏幕 可 见 
pygame.display.flip() 


对 编组 调用 draw() 时 ，Pygame 自 动 绘制 编组 的 每 个 元 素 ， 绘 制 位 置 由 元 素 的 属性 rect 决 定 。 
在 这 里 ，aliens.draw(screen) 在 屏幕 上 绘制 编组 中 的 每 个 外 星人 。 


13.3.3 ”创建 外 星人 群 


现在 可 以 创建 外 星人 群 了 。 下 面 是 新 函数 create_fleet()， 我们 将 它 放 在 game_functions. 
py 的 末尾 。 我们 还 需要 导入 Alien 类 , 因此 务必 在 文件 game_functions.py 开 头 添 加 相应 的 import 
语句 : 


game _functions.py 


-- Ship-- 

from bullet import Bullet 
from alien import Alien 
-- SNip-- 


def create fleet(ai settings, screen, aliens): 
"创建 外 星人 群 "" 
# 创建 一 个 外 星人 ， 并 计算 一 行 可 容纳 多 少 个 外 星人 
# 外 星人 间距 为 外 星人 宽度 
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© alien = Alien(ai settings, screen) 
2 alien width = alien.rect.width 
3 available space x = ai settings.screen width - 2 * alien width 
@ number aliens x = int(available space x / (2 * alien width)) 
# 创建 第 一 行 外 星人 
© for alien number in range(number aliens x): 


# 创建 一 个 外 星人 并 将 其 加 入 当前 行 

alien = Alien(ai settings, screen) 

alien.x = alien width + 2 * alien width * alien number 
alien.rect.x = alien.x 

aliens.add(alien) 


这 些 代码 大 都 在 前 面 详细 介绍 过 。 为 放置 外 星人 , 我们 需要 知道 外 星人 的 宽度 和 高 度 ， 因 此 
在 执行 计算 前 ， 我 们 先 创建 一 个 外 星人 见 @ )。 这 个 外 星人 不 是 外 星人 群 的 成 员 ， 因 此 没有 将 
它 加 入 到 编组 aliens 中 。 在 @ 处 ,我们 从 外 星人 的 rect 属 性 中 获取 外 星人 宽度 ， 并 将 这 个 值 存储 
到 alien width 中 ,以 免 反 复 访问 属性 rect。 在 @ 处 , 我 们 计算 可 用 于 放置 外 星人 的 水 平 空间 ,以 
及 其 中 可 容纳 多 少 个 外 星人 。 

相 比 于 前 面 介绍 的 工作 ， 这 里 唯一 的 不 同 是 使 用 了 int() 来 确保 计算 得 到 的 外 星人 数量 为 整 
数 ( 见 @ )， 因 为 我 们 不 希望 某 个 外 星人 只 显示 一 部 分 ， 而 且 函 数 range() 也 需要 一 个 整数 。 函 数 
int() 将 小 数 部 分 丢弃 ， 相 当 于 向 下 圆 整 (这 大 有 神 益 ， 因 为 我 们 宁愿 每 行 都 多 出 一 点 点 空间 ， 
也 不 希望 每 行 的 外 星人 之 间 过 于 拥挤 

接 下 来 ， 我 们 编写 了 一 个 循环 ， 它 从 零 数 到 要 创建 的 外 星人 数 ( 见 @ )。 在 这 个 循环 的 主体 
中 ,我们 创建 一 个 新 的 外 星人 ， 并 通过 设置 x 坐标 将 其 加 入 当前 行 ( 见 @ )。 将 每 个 外 星人 都 往 右 
推 一 个 外 星人 的 宽度 。 接 下 来 ,我们 将 外 星人 宽度 乘 以 3， 得 到 每 个 外 星人 占据 的 空间 ( 其 中 包 
括 其 右边 的 空白 区 域 )， 再 据 此 计算 当前 外 星人 在 当前 行 的 位 置 。 最 后 ， 我 们 将 每 个 新 创建 的 外 
星人 都 添加 到 编组 aliens 中 。 

如 果 你 现在 运行 这 个 游戏 ,将 看 到 第 一 行 外 星人 ， 如 图 13-3 所 示 。 


Na 


[e] 
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会 


图 13-3 ”第 一 行 外 星人 


这 行 外 星人 在 屏幕 上 稍微 偏向 了 左边 ,这 实际 上 是 有 好 处 的 ,因为 我 们 将 让 外 星人 群 往 右 移 ， 
触及 屏幕 边缘 后 稍微 往 下 移 ， 然 后 往 左 移 ， 以 此 类 推 。 就 像 经 典 游戏 《太空 人 侵 者 》 相 比 于 只 
往 下 移 , 这 种 移动 方式 更 有 趣 。 我 们 将 让 外 形 人 群 不 断 这 样 移动 ， 直 到 所 有 外 星人 都 被 击落 或 有 
外 星人 撞 上 飞船 或 抵达 屏幕 底 端 。 


注意 根据 你 选择 的 屏幕 宽度 ， 在 你 的 系统 中 ， 第 一 行 外 星人 的 位 置 可 能 稍 有 不 同 。 | 


13.3.4 重 构 create fleet() 


倘若 我 们 创建 了 外 星人 群 ， 也 许 应 该 让 create_ fleet() 保 持原 样 ， 但 鉴于 创建 外 星人 的 工作 
还 未 完成 ,我们 稍微 清理 一 下 这 个 函数 。 下 面 是 create_fleet() 和 两 个 新 函数 ，get_number_ 


aliens x() 和 和 create alien(): 


game_functions.py 


@ def get number aliens x(ai settings, alien width) 
"" "计算 每 行 可 容纳 多 少 个 外 星人 """ 
available space x = ai settings.screen width - 2 * alien width 
number aliens x = int(available space x / (2 * alien width)) 
return number aliens x 


def create alien(ai settings, screen, aliens, alien number): 
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""" 创 建 一 个 外 星人 并 将 其 放 在 当前 行 """ 
alien = Alien(ai settings, screen) 
2 alien width = alien.rect.width 
alien.x = alien width + 2 * alien width * alien number 
alien.rect.x = alien.x 
aliens.add(alien) 


def create fleet(ai settings, screen, aliens): 
""" 创 建 外 星人 群 """ 
# 创建 一 个 外 星人 ， 并 计算 每 行 可 容纳 多 少 个 外 星人 
alien = Alien(ai settings, screen) 
3 number aliens x = get number aliens x(ai settings, alien.rect.width) 


# 创建 第 一 行 外 星人 
for alien number in range(number aliens x): 
0 create alien(ai settings, screen, aliens, alien number) 


函数 get_number_aliens_x() 的 代码 都 来 自 create_fleet()， 且 未 做 任何 修改 ( 见 @ )。 函 数 
create_alien() 的 代码 也 都 来 自 create fleet()， 且 未 做 任何 修改 ， 只 是 使 用 刚 创 建 的 外 星人 来 
获取 外 星人 宽度 ( 见 @ ), 在 四 处 , 我 们 将 计算 可 用 水 平 空 间 的 代码 替换 为 对 get_numper_aliens_x() 
的 调用 , 并 删除 了 引用 alien_width 的 代码 行 , 因为 现在 这 是 在 create_alien() 中 处 理 的 。 在 @ 处 ， 
我 们 调用 create_alien()。 通 过 这 样 的 重 构 ， 添 加 新 行进 而 创建 整 群 外 星人 将 更 容易 。 


13.3.5 ”添加 行 

要 创建 外 星人 群 ,需要 计算 屏幕 可 容纳 多 少 行 ,并 对 创建 一 行 外 星人 的 循环 重复 相应 的 次 数 。 
为 计算 可 容纳 的 行 数 , 我 们 这 样 计算 可 用 垂直 空间 : 将 屏幕 高 度 减 去 第 一 行 外 星人 的 上 边 距 ( 外 
星人 高 度 )、 飞 船 的 高 度 以 及 最 初 外 星人 群 与 飞船 的 距离 ( 外 星人 高 度 的 两 倍 ): 


available space y = ai settings.screen height - 3 * alien height - ship height 


这 将 在 飞船 上 方 留 出 一 定 的 空白 区 域 ， 给 玩家 留 出 射 杀 外 星人 的 时 间 。 

每 行 下 方 都 要 留 出 一 定 的 空白 区 域 , 并 将 其 设置 为 外 星人 的 高 度 。 为 计算 可 容纳 的 行 数 , 我 
们 将 可 用 垂直 空间 除 以 外 星人 高 度 的 两 倍 ( 同样 ， 如 果 这 样 的 计算 不 对 ,我 们 马上 就 能 发 现 , 继 
而 将 间距 调整 为 合理 的 值 )。 


number rows = available height y / (2 * alien height) 


知道 可 容纳 多 少 行 后 ， 便 可 重复 执行 创建 一 行 外 星人 的 代码 : 


game functions.py 


@ def get number rows(ai settings, ship height, alien height): 
"" "计算 屏幕 可 容纳 多 少 行 外 星人 """ 
2 available space y = (ai settings.screen height - 
(3 * alien height) - ship height) 
number rows = int(available space y / (2 * alien height)) 
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return number rows 


def create alien(ai settings, screen, aliens, alien number, row number): 
-- Snip-- 


alien.x = alien width + 2 * alien width * alien number 
alien.rect.x = alien.x 
(3 alien.rect.y = alien.rect.height + 2 * alien.rect.height * row number 


aliens.add(alien) 


def create fleet(ai settings, screen, ship, aliens): 
-- Ship-- 
number aliens x = get number aliens x(ai settings, alien.rect.width) 
number rows = get number rows(ai settings, ship.rect.height, 
alien.rect.height) 


# 创建 外 星人 群 
4 for row number in range(number rows): 
for alien number in range(number aliens x): 
create alien(ai settings, screen, aliens, alien number, 
row_ number) 


为 计算 屏幕 可 容纳 多 少 行 外 星人 ， 我 们 在 函数 get_number_rows() 中 实现 了 前 面 计算 
available_space_y 和 number_rows 的 公式 ( 见 @ )， 这 个 函数 与 get_number_aliens_x() 类 似 。 计 算 
公式 用 括号 括 起 来 了 ， 这 样 可 将 代码 分 成 两 行 ， 以 遵循 每 行 不 超过 79 字 符 的 建议 ( 见 @ )。 这 里 
使 用 了 int()， 因 为 我 们 不 想 创建 不 完整 的 外 星人 行 。 

为 创建 多 行 ， 我 们 使 用 两 个 散 套 在 一 起 的 循环 ， 一 个 外 部 循环 和 一 个 内 部 循环 ( 见 @ )。 其 
中 的 内 部 循环 创建 一 行 外 星人 ， 而 外 部 循环 从 零 数 到 要 创建 的 外 星人 行 数 。Python 将 重复 执行 创 
建 单行 外 星人 的 代码 ， 重 复 次 数 为 number rows。 

为 艇 套 循环 , 我 们 编写 了 一 个 新 的 for 循 环 , 并 缩 进 了 要 重复 执行 的 代码 。( 在 大 多 数 文本 编 
辑 器 中 ， 缩 进 代 码 块 和 取消 缩 进 都 很 容易 ， 详 情 请 参阅 附录 B。) 我 们 调用 create alien() 时 , 传 
递 了 一 个 表示 行 号 的 实 参 ， 将 每 行 都 沿 屏幕 依次 向 下 放置 。 

create_alien() 的 定义 需要 一 个 用 于 存储 行 号 的 形 参 。 在 create_alien() 中 ， 我 们 修改 外 星 
人 的 y 坐 标 ( 见 @ )， 并 在 第 一 行 外 星人 上 方 留 出 与 外 星人 等 高 的 空白 区 域 。 相 邻 外 星人 行 的 ?从 
标 相 差 外 星人 高 度 的 两 倍 , 因 此 我 们 将 外 星人 高 度 乘 以 2， 再 乘 以 行 号 。 第 一 行 的 行 号 为 0， 因 此 
第 一 行 的 垂直 位 置 不 变 ， 而 其 他 行 都 沿 屏幕 依次 向 下 放置 。 

在 create fleet() 的 定义 中 ， 还 新 增 了 一 个 用 于 存储 ship 对 象 的 形 参 ， 因 此 在 
alien invasion.py 中 调用 create fleet() 时 ,需要 传递 实 参 ship: 


alien_invasion.py 


# 创建 外 星人 群 
gf.create fleet(ai settings, screen, ship, aliens) 


如 果 你 现在 运行 这 个 游戏 ,将 看 到 一 群 外 星人 ， 如 图 13-4 所 示 。 
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会 
图 13-4 整 群 外 星人 都 现 身 了 
在 下 一 方 ， 我们 将 让 外 星人 群 动 起 来 ! 


动手 试 一 试 
13-1 星星 : 找 一 幅 星 星 图 像 ， 并 在 屏幕 上 显示 一 系列 整齐 排列 的 星星 。 
13-2 更 逼真 的 星星 : 为 让 星星 的 分 布 更 逼真 ， 可 随机 地 放置 星星 。 本 书 前 面 说 过 ， 
可 像 下 面 这 样 来 生成 随机 数 : 


from random import randint 
random number = randint(-10,10) 


上 述 代 码 返 回 一 个 -10 和 10 之 间 的 随机 整数 ,在 为 完成 练习 13-1 而 编写 的 程序 中 ， 
随机 地 调整 每 颗 星 星 的 位 置 。 


13.4 ”让 外 星人 群 移动 


下 面 来 让 外 星人 群 在 屏幕 上 向 右 移 动 , 撞 到 屏幕 边缘 后 下 移 一 定 的 距离 ,再 沿 相 反 的 方向 移 
动 。 我 们 将 不 断 地 移动 所 有 的 外 星人 ,直到 所 有 外 星人 都 被 消灭 ,有 外 星人 撞 上 飞船 ， 或 有 外 星 
人 抵达 屏幕 底 端 。 下 面 先 来 让 外 星人 向 右 移动 。 
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13.4.1 向 右 移动 外 星人 


为 移动 外 星人 , 我 们 将 使 用 alien.py 中 的 方法 update(), 且 对 外 星人 群 中 的 每 个 外 星人 都 调用 
它 。 首 先 ， 添加 一 个 控制 外 星人 速度 的 设置 : 
settings.py 


def init (self): 
--SNnip-- 
# 外 星人 设置 
self.alien speed factor = 1 


然后 ， 使 用 这 个 设置 来 实现 update(): 


alien.py 


def update(self): 
mu 向 右 移动 外 星人 """ 
self.x += self.ai settings.alien speed factor 
self.rect.x = self.x 


Q@ ee 


每 次 更 新 外 星人 位 置 时 ， 都 将 它 向 右 移动 ， 移 动量 为 alien_speed_factor 的 值 。 我 们 使 用 属 
性 self.x 跟 踪 每 个 外 星人 的 准确 位 置 ， 这 个 属性 可 存储 小 数值 ( 见 @ )。 然 后 ， 我 们 使 用 self.x 
的 值 来 更 新 外 星人 的 rect 的 位 置 ( 见 @ )。 
在 主 while 循 环 中 已 调用 了 更 新 飞船 和 子弹 的 方法 ,但 现在 还 需 更 新 每 个 外 星人 的 位 置 : 


alien_invasion.py 


# 开始 游戏 主 循环 
while True: 
gf.check events(ai settings, screen, ship, bullets) 
ship.update() 
gf.update bullets(bullets) 
gf.update aliens(aliens) 
gf.update screen(ai settings, screen, ship, aliens, bullets) 


我 们 在 更 新 子弹 后 再 更 新 外 星人 的 位 置 ， 因 为 稍 后 要 检查 是 否 有 子弹 撞 到 了 外 星人 。 
最 后 ， 在 文件 game_functions.py 末 尾 添 加 新 函数 update_ aliens(): 


game functions.py 


def update aliens(aliens): 
""" 更 新 外 星人 群 中 所 有 外 星人 的 位 置 """ 
aliens.update() 


我 们 对 编组 aliens 调 用 方法 update()， 这 将 自动 对 每 个 外 星人 调用 方法 update()。 如 果 你 现 
在 运行 这 个 游戏 ， 会 看 到 外 星人 群 向 右 移 ， 并 逐渐 在 屏幕 右边 缘 消失 。 
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13.4.2 ”创建 表示 外 星人 移动 方向 的 设置 


下 面 来 创建 让 外 星人 撞 到 屏幕 右边 缘 后 向 下 移动 、 再 向 左 移动 的 设置 。 实 现 这 种 行为 的 代码 
如 下 : 


settings.py 


# 外 星人 设置 

self.alien speed factor = 1 
self.fleet drop speed = 10 

# fleet direction 为 1 表示 向 右 移 ， 为 -1 表示 向 左 移 
self.fleet direction = 1 


设置 fleet drop_speed 指 定 了 有 外 星人 撞 到 屏幕 边缘 时 ， 外 星人 群 向 下 移动 的 速度 。 将 这 个 
速度 与 水 平 速 度 分 开 是 有 好 处 的 ， 这 样 你 就 可 以 分 别 调整 这 两 种 速度 了 。 

要 实现 fleet_direction 设 置 ， 可 以 将 其 设置 为 文本 值 ， 如 'left' 或 'right' ， 但 这 样 就 必须 
编写 if-elif 语 句 来 检查 外 星人 群 的 移动 方向 。 鉴 于 只 有 两 个 可 能 的 方向 , 我 们 使 用 值 1 和 -1 来 表 
示 它 们 , 并 在 外 星人 群 改变 方向 时 在 这 两 个 值 之 间 切 换 。 男 外 ， 鉴于 向 右 移 动 时 需要 增 大 每 个 外 
星人 的 x 坐标 ， 而 向 左 移 动 时 需要 减 小 每 个 外 星人 的 x 坐标 ， 使 用 数字 来 表示 方向 更 合理 。 


13.4.3 ”检查 外 星人 是 否 撞 到 了 屏幕 边缘 


现在 需要 编写 一 个 方法 来 检查 是 否 有 外 星人 撞 到 了 屏幕 边缘 ， 还 需 修改 update() ， 以 让 每 个 
外 星人 都 治 正确 的 方向 移动 : 


alien.py 


def check edges(self): 
"如 果 外 星人 位 于 屏幕 边缘 ， 就 返回 TrUe”"" 
screen rect = self.screen.get rect() 


© if self.rect.right >= screen rect.right: 
return True 
@ elif self.rect.left <= 0: 


return True 


def update(self) : 
""" 向 左 或 向 右 移动 外 星人 """ 
3 self.x += (self.ai settings.alien speed factor * 
self.ai settings.fleet direction) 
self.rect.x = self.x 


我 们 可 对 任何 外 星人 调用 新 方法 check_edges() ， 看 看 它 是 否 位 于 屏幕 左边 缘 或 右边 缘 。 如 
果 外 星人 的 rect 的 right 属 性 大 于 或 等 于 屏幕 的 rect 的 right 属 性 ， 就 说 明 外 星人 位 于 屏幕 右边 缘 
( 见 @ )。 如 果 外 星人 的 rect 的 left 属 性 小 于 或 等 于 0， 就 说 明 外 星人 位 于 屏幕 左边 缘 ( 见 @ )。 

我 们 修改 了 方法 update(), 将 移动 量 设置 为 外 星人 速度 和 fleet_direction 的 乘积 , 让 外 星人 
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向 左 或 向 右 移 。 如 果 fleet direction 为 1， 就 将 外 星人 当前 的 x 坐 标 增 大 alien_speed factor， 从 
而 将 外 星人 向 右 移 ; 如 果 fleet _direction 为 -1， 就 将 外 星人 当前 的 x 坐标 减 去 alien speed_ 
factor， 从 而 将 外 星人 向 左 移 。 


13.4.4 ”向 下 移动 外 星人 群 并 改变 移动 方向 


有 外 星人 到 达 屏 幕 边缘 时 ， 需 要 将 整 群 外 星人 下 移 ， 并 改变 它们 的 移动 方向 。 我 们 需要 对 
game_functions.py 做 重大 修改 , 因为 我 们 要 在 这 里 检查 是 否 有 外 星人 到 达 了 左边 缘 或 右边 缘 。 为 此 ， 
我 们 编写 函数 check fljeet_ edges() 和 change fleet direction()， 并 对 update aliens() 进 行 修改 : 


game _ functions.py 


def check fleet edges(ai settings, aliens): 
""" 有 外 星人 到 达 边 缘 时 采取 相应 的 措施 """ 
@ for alien in aliens.sprites(): 
if alien.check edges() : 
change fleet direction(ai settings, aliens) 
break 


def change fleet direction(ai settings, aliens): 
""" 将 整 群 外 星人 下 移 ， 并 改变 它们 的 方向 """ 
for alien in aliens.sprites(): 
© alien.rect.y += ai settings.fleet drop speed 
ai settings.fleet direction *= -1 


def update aliens(ai settings, aliens): 


检查 是 否 有 外 星人 位 于 屏幕 边缘 ， 并 更 新 整 群 外 星人 的 位 置 


(3 check fleet edges(ai settings, aliens) 
aliens.update() 


在 check_fleet edges() 中 ,我 们 遍历 外 星人 群 ， 并 对 其 中 的 每 个 外 星人 调用 check_edges() 
( 见 @ )。 如 果 check_edges() 返 回 True, 我 们 就 知道 相应 的 外 星人 位 于 屏幕 边缘 ,需要 改变 外 星人 
群 的 方向 , 因此 我 们 调用 change_fleet direction() 并 退出 循环 。 在 change fleet direction() 中 ， 
我 们 遍历 所 有 外 星人 ， 将 每 个 外 星人 下 移 fleet drop_speed 设 置 的 值 ( 见 @ ); 然后 ， 将 fleet 
direction 的 值 修改 为 其 当前 值 与 -1 的 乘积 。 

我 们 修改 了 函数 update aliens() ,在 其 中 通过 调用 check fleet edges() 来 确定 是 否 有 外 星人 
位 于 屏幕 边缘 。 现 在 ， 函 数 update aliens() 包 含 形 参 ai settings， 因 此 我 们 调用 它 时 指定 了 与 
ai settings 对 应 的 实 参 : 


alien_invasion.py 


# 开始 游戏 主 循环 
while True: 
gf.check events(ai settings, screen, ship, bullets) 
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ship.update() 

gf.update bullets(bullets) 

gf.update aliens(ai settings, aliens) 

gf.update screen(ai settings, screen, ship, aliens, bullets) 


如 果 你 现在 运行 这 个 游戏 ， 外 星人 群 将 在 屏幕 上 来 回 移动 ， 并 在 抵达 屏幕 边缘 后 向 下 移动 。 
现在 可 以 开始 射 杀 外 星人 ,检查 是 否 有 外 星人 撞 到 飞船 ， 或 抵达 了 屏幕 底 端 。 


动手 试 一 试 
13-3 雨滴 : 寻找 一 幅 雨 滴 图 像 ， 并 创建 一 系列 整齐 排列 的 雨滴 。 让 这 些 雨滴 往 下 


落 ， 直 到 到 达 屏 幕 底 端 后 消失 。 
13-4 连绵 细 雨 : 修改 为 完成 练习 13-3 而 编写 的 代码 ， 使 得 一 行 雨滴 消失 在 屏幕 底 
端 后 ， 屏 幕 顶 端 又 出 现 一 行 新 雨滴 ， 并 开始 往 下 落 。 


13.5 ” 射 杀 外 星人 


我 们 创建 了 飞船 和 外 星人 群 , 但 子弹 击 中 外 星人 时 , 将 穿 过 外 星人 ， 因 为 我 们 还 没有 检查 碰 
撞 。 在 游戏 编程 中 ， 碰 撞 指 的 是 游戏 元 素 重 受 在 一 起 。 要 让 子弹 能 够 击落 外 星人 ， 我 们 将 使 用 
sprite.groupcollide() 检 测 两 个 编组 的 成 员 之 间 的 碰撞 。 


13.5.1 ”检测 子弹 与 外 星人 的 碰撞 


子弹 击 中 外 星人 时 , 我 们 要 马上 知道 ,以便 碰撞 发 生 后 让 外 星人 立即 消失 。 为 此 , 我们 将 在 
更 新 子弹 的 位 置 后 立即 检测 碰撞 。 
方法 sprite.groupcollide() 将 每 颗 子弹 的 rect 同 每 个 外 星人 的 rect 进 行 比较 ,并 返回 一 个 字 
典 ， 其 中 包含 发 生 了 碰撞 的 子弹 和 外 星人 。 在 这 个 字典 中 ， 每 个 键 都 是 一 颗 子 弹 ， 而 相应 的 值 都 
是 被 击 中 的 外 星人 (第 14 章 实现 记分 系统 时 ， 也 会 用 到 这 个 字典 )。 
在 函数 update_bullets() 中 ,使 用 下 面 的 代码 来 检查 碰撞 : 


game_functions.py 


def update_ bullets(aliens, a 
ee 置 ， 并 删除 肖 失 的 子弹 " 
# 检 益 是 否 有 子弹 去 中 了 外 里 人 
# 如 果 是 这 样 ， 就 删除 相应 的 子弹 和 外 星人 
collisions = pygame.sprite.groupcollide(bullets, aliens, True, True) 


新 增 的 这 行 代码 遍历 编组 bullets 中 的 每 颗 子 弹 ， 再 遍历 编组 aliens 中 的 每 个 外 星人 。 每 当 
有 子弹 和 外 星人 的 rect 重 肆 时 ，groupcollide() 就 在 它 返回 的 字典 中 添加 一 个 键 - 值 对 。 两 个 实 参 
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True 告 诉 Pygame 删 除 发 生 碰 撞 的 子弹 和 外 星人 。( 要 模拟 能 够 穿行 到 屏幕 顶端 的 高 能 子弹 一 一 消 
灭 它 击 中 的 每 个 外 星人 ， 可 将 第 一 个 布尔 实 参 设 置 为 False， 并 让 第 二 个 布尔 实 参 为 True。 这 样 
被 击 中 的 外 星人 将 消失 ， 但 所 有 的 子弹 都 始终 有 效 ， 直 到 抵达 屏幕 项 端 后 消失 。) 

我 们 调用 update_bullets() 时 ， 传 递 了 实 参 aliens 


alien_invasion.py 


# 开始 游戏 主 循环 
while True: 
gf.check events(ai settings, screen, ship, bullets) 
ship.update() 
gf.update bullets(aliens, bullets) 
gf.update aliens(ai settings, aliens) 
gf.update screen(ai settings, screen, ship, aliens, bullets) 


如 果 你 此 时 运行 这 个 游戏 , 被 击 中 的 外 星人 将 消失 。 如 图 13-5 所 示 ， 其 中 有 一 部 分 外 星人 被 
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图 13-5 ”可 以 射 杀 外 星人 了 


13.5.2 ”为 测试 创建 大 子弹 

只 需 通 过 运行 这 个 游戏 就 可 以 测试 其 很 多 功能 ， 但 有 些 功 能 在 正常 情况 下 测试 起 来 比较 烦 
琐 。 例 如 ， 要 测试 代码 能 吞 正确 地 处 理 外 星人 编组 为 空 的 情形 ， 需 要 花 很 长 时 间 将 屏幕 上 的 外 星 
人 都 击落 。 
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测试 有 些 功能 时 , 可 以 修改 游戏 的 某 些 设置 ,以 便 专 注 于 游戏 的 特定 方面 。 例如 ,可 以 缩小 屏 
幕 以 减少 需要 击落 的 外 星人 数量 ， 也 可 以 提高 子弹 的 速度 ， 以 便 能 够 在 单位 时 间 内 发 射 大 量子 弹 。 

测试 这 个 游戏 时 ， 我 喜欢 做 的 一 项 修改 是 增 大 子弹 的 尺寸 ， 使 其 在 击 中 外 星人 后 依然 有 效 ， 
如 图 13-6 所 示 。 请 尝试 将 bullet_ width 设置 为 300， 看 看 将 所 有 外 星人 都 射 杀 有 多 快 ! 

类 似 这 样 的 修改 可 提高 测试 效率 ， 还 可 能 激发 出 如 何 赋予 玩家 更 大 威力 的 思想 火花 。( 完成 
测试 后 ， 别 忘 了 将 设置 恢复 正常 。) 


化 化 贫 了 化 沸 


荐 和 芍 
其 
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图 13-6 ”威力 更 大 的 子弹 让 游戏 的 有 些 方法 测试 起 来 更 容易 


13.5.3 生成 新 的 外 星人 群 
这 个 游戏 的 一 个 重要 特点 是 外 星人 无 穷 无 尽 , 一 个 外 星人 和 群 被 消灭 后 ,又 会 出 现 一 群 外 星人 。 
要 在 外 星人 和 群 被 消灭 后 又 显示 一 群 外 星人 ， 首 先 需 要 检查 编组 aliens 是 否 为 空 。 如 果 为 空 ， 
就 调用 create_fleet()。 我 们 将 在 update_bullets() 中 执行 这 种 检查 ， 因 为 外 星人 都 是 在 这 里 被 
消灭 的 : 


game _ functions.py 


def update bullets(ai settings, screen, ship, aliens, bullets): 
-- Snip-- 
# 检查 是 否 有 子弹 击 中 了 外 星人 
# 如 果 是 ， 就 删除 相应 的 子弹 和 外 星人 
collisions = pygame.sprite.groupcollide(bullets, aliens, True, True) 


© if len(aliens) == 0: 
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# 删除 现 有 的 子弹 并 新 建 一 群 外 星人 
© bullets.empty() 
create fleet(ai settings, screen, ship, aliens) 


在 @ 处 ,我 们 检查 编组 aliens 是 否 为 空 。 如 果 是 ,就 使 用 方法 empty() 删 除 编组 中 余下 的 所 
有 精灵 ， 从 而 删除 现 有 的 所 有 子弹 。 我 们 还 调用 了 create_fleet() ， 再 次 在 屏幕 上 显示 一 群 外 
星人 。 

现在 ，update_bullets() 的 定义 包含 额外 的 形 参 ai settings、screen 和 ship， 因 此 我 们 需要 
更 新 alien_invasion.py 中 对 update_bullets() 的 调用 : 


alien_invasion.py 


# 开始 游戏 主 循环 

while True: 
gf.check events(ai settings, screen, ship, bullets) 
ship.update() 
gf.update bullets(ai settings, screen, ship, aliens, bullets) 
gf.update aliens(ai settings, aliens) 
gf.update screen(ai settings, screen, ship, aliens, bullets) 


现在 ， 当 前 外 星人 群 消灭 干净 后 ， 将 立刻 出 现 一 个 新 的 外 星人 群 。 


13.5.4 提高 子弹 的 速度 


如 果 你 现在 尝试 在 这 个 游戏 中 射 杀 外 星人 , 可 能 发 现 子 弹 的 速度 比 以 前 慢 , 这 是 因为 在 每 次 
循环 中 ，Pygame 需 要 做 的 工作 更 多 了 。 为 提高 子弹 的 速度 ， 可 调整 settings.py 中 
bullet_speed factor 的 值 。 例 如 ， 如 果 将 这 个 值 增 大 到 3 ， 子 弹 在 屏幕 上 向 上 穿行 的 速度 将 变 得 


相当 快 : 3 


settings.py 


# 子弹 设置 
self.bullet _ speed factor = 3 
self.bullet width = 3 


-- Snip-- 


这 项 设置 的 最 佳 值 取决 于 你 的 系统 速度 ， 请 找 出 适合 你 的 值 吧 。 


13.5.5 重 构 update bullets() 


下 面 来 重 构 update_bullets() ， 使 其 不 再 完成 那么 多 任务 。 我 们 将 把 处 理子 弹 和 外 星人 碰撞 
的 代码 移 到 一 个 独立 的 函数 中 : 


game_functions.py 


def update bullets(ai settings, screen, ship, aliens, bullets): 
-- Snip-- 
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# 
并 


删除 已 消失 的 子弹 
for 


中 

bullet in bullets.copy(): 

if bullet.rect.bottom <= 0: 
bullets.remove(bullet) 


check bullet alien collisions(ai settings, screen, ship, aliens, bullets) 


def check bullet alien collisions(ai settings, screen, ship, aliens, bullets): 
mn 响应 子弹 和 外 星人 的 碰撞 """ 
# 删除 发 生 碰撞 的 子弹 和 外 星人 


collisions = pygame.sprite.groupcollide(bullets, aliens, True, True) 


if len(aliens) == 0: 
# 删除 现 有 的 所 有 子弹 ， 并 创建 一 个 新 的 外 星人 群 
bullets.empty() 
create fleet(ai settings, screen, ship, aliens) 


我 们 创建 了 一 个 新 函数 一 一 check_bullet alien collisions()， 以 检测 子弹 和 外 星人 之 间 的 
碰撞 ， 以 及 在 整 群 外 星人 都 被 消灭 干净 时 采取 相应 的 措施 。 这 避免 了 update_bullets() 太 长 ， 简 
化 了 后 续 的 开发 工作 。 


动手 试 一 斌 
13-5 抓 球 : 创建 一 个 游戏 ， 在 屏幕 底 端 放置 一 个 玩家 可 左右 移动 的 角色 。 让 一 个 


球 出 现在 屏幕 顶端， 且 水 平 位 置 是 随机 的 ， 并 让 这 个 球 以 固定 的 速度 往 下 落 。 如 果 角 色 
与 球 发 生 碰 接 (表示 将 球 抓 住 了 )， 就 让 球 消失 。 每 当 角 色 抓 住 球 或 球 因 抵达 屏幕 底 端 
而 消失 后 ， 都 创建 一 个 新 球 。 


13.6 ”结束 游戏 


如 果 玩 家 根本 不 会 输 , 游戏 还 有 什么 趣味 和 挑战 性 可 言 ? 如果 玩家 没 能 在 足够 短 的 时 间 内 将 
整 群 外 星人 都 消灭 干净 ， 且 有 外 星人 撞 到 了 飞船 ， 飞 船 将 被 摧毁 。 与 此 同时 ,我 们 还 限制 了 可 供 
玩家 使 用 的 飞船 数 ， 而 有 外 星人 抵达 屏幕 底 端 时 ， 飞 船 也 将 被 摧毁 。 玩 家 用 光 了 飞船 后 ,游戏 便 
绩 束 。 
13.6.1 检测 外 星人 和 飞船 碰撞 

我 们 首先 检查 外 星人 和 飞船 之 间 的 碰撞 ， 以 便 外 星人 撞 上 飞船 时 我 们 能 够 作出 合适 的 响应 。 
我 们 在 更 新 每 个 外 星人 的 位 置 后 立即 检测 外 星人 和 飞船 之 间 的 碰撞 。 


game _ functions.py 


def update aliens(ai settings, ship, aliens): 
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检查 是 否 有 外 星人 到 达 屏 幕 边 缘 
新 所 有 外 星人 的 位 置 


check fleet edges(ai settings, aliens) 
aliens.update() 


# 检测 外 星人 和 飞船 之 间 的 碰撞 
© if pygame.sprite.spritecollideany(ship, aliens) 
@ print("Ship hit!!1") 


方法 spritecollideany() 接 受 两 个 实 参 : 一 个 精灵 和 一 个 编组 。 它 检查 编组 是 否 有 成 员 与 精 
灵 发 生 了 和 碰撞， 并 在 找到 与 精灵 发 生 了 碰撞 的 成 员 后 就 停止 志 历 编组 。 在 这 里 ， 它 遍历 编组 
aliens， 并 返回 它 找到 的 第 一 个 与 飞船 发 生 了 碰撞 的 外 星人 。 

如 果 没 有 发 生 碰撞 ，spritecollideany() 将 返回 None， 因 此 @ 处 的 if 代 码 块 不 会 执行 。 如 果 
找到 了 与 飞船 发 生 碰撞 的 外 星人 , 它 就 返回 这 个 外 星人 , 因此 if 代码 块 将 执行 : 打印 “Ship hit!!!” 
( 见 @ )。( 有 外 星人 撞 到 飞船 时 ， 需 要 执行 的 任务 很 多 : 需要 删除 余下 的 所 有 外 星人 和 子弹 ， 让 
飞船 重新 居中 ， 以 及 创建 一 群 新 的 外 星人 。 编 写 完 成 这 些 任务 的 代码 前 ， 需 要 确定 检测 外 星人 和 
飞船 碰撞 的 方法 是 否 可 行 。 而 为 确定 这 一 点 ， 最 简单 的 方式 是 编写 一 条 print 语 句 。 ) 

现在 ， 我 们 需要 将 ship 传 递 给 update_aliens(): 


出 


alien_invasion.py 


# 开始 游戏 主 循环 

while True: 
gf.check events(ai settings, screen, ship, bullets) 
ship.update() 
gf.update bullets(ai settings, screen, ship, aliens, bullets) 
gf.update aliens(ai settings, ship, aliens) 
gf.update screen(ai settings, screen, ship, aliens, bullets) 


现在 如 果 你 运行 这 个 游戏 ， 则 每 当 有 外 星人 撞 到 飞船 时 ， 终 端 窗口 都 将 显示 “Ship hit!!!”。 
测试 这 项 功能 时 , 请 将 alien drop_speed 设 置 为 较 大 的 值 ， 如 50 或 100, 这 样 外 星人 将 更 快 地 撞 到 
飞船 。 


13.6.2 ”响应 外 星人 和 飞船 碰撞 


现在 需要 确定 外 星人 与 飞船 发 生 碰 撞 时 ， 该 做 些 什么 。 我 们 不 销毁 ship 实 例 并 创建 一 个 新 的 
ship 实 例 ， 而 是 通过 跟踪 游戏 的 统计 信息 来 记录 飞船 被 撞 了 多 少 次 〈 跟 踪 统 计 信 息 还 有 助 于 记 
分 )。 

下 面 来 编写 一 个 用 于 跟踪 游戏 统计 信息 的 新 类 
game stats.py: 


GameStats ， 并 将 其 保存 为 文件 


game _stats.py 


class GameStats(): 
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""" 跟 踪 游 戏 的 统计 信息 """ 


def init (self, ai settings): 
中 初始 化 统计 信息 """ 
self.ai settings = ai settings 
© self.reset stats() 


def reset stats(self): 
"" 初 始 化 在 游戏 运行 期 间 可 能 变化 的 统计 信息 """ 
self.ships left = self.ai settings.ship limit 


在 这 个 游戏 运行 期 间 ， 我 们 只 创建 一 个 GameStats 实 例 ， 需要 重 
置 一 些 统计 信息 。 为 此 ,我 们 在 方法 reset_stats() 中 初始 化 大 部 分 统计 信息 , 而 不 是 在 _init_() 
中 直接 初始 化 它们 。 我 们 在 ”init () 中 调用 这 个 方法 ， ee 2 善 地 设置 
这 些 统计 信息 ( 见 @ )， 同 时 在 玩家 开始 新 游戏 时 也 能 调用 reset_stats()。 

当前 只 有 一 项 统计 信息 一 一 ships_left， 其 值 在 游戏 运行 期 间 将 不 断 变化 。 一 开始 玩家 拥有 
的 飞船 数 存储 在 settings.py 的 ship 1imit 中 : 


settings.py 


上 飞身 证 更 
# 飞船 设置 


self.ship speed factor = 1.5 
self.ship limit = 3 


我 们 还 需 对 alien_ invasion.py 做 些 修改 ， 以 创建 一 个 GameStats 实 例 : 


alien_invasion.py 


-- Snip-- 
from settings import Settings 

@ from game stats import GameStats 
-- Snip-- 


def run game(): 
-- Snip-- 
pygame.display.set caption("Alien Invasion") 


# 创建 一 个 用 于 存储 游戏 统计 信息 的 实例 
@ stats = GameStats(ai settings) 
-- SNip-- 
# 开始 游戏 主 循环 
while True: 
-- Snip-- 
gf.update bullets(ai settings, screen, ship, aliens, bullets) 
[32 gf.update aliens(ai settings, stats, screen, ship, aliens, bullets) 
-- Snip-- 


我 们 导入 了 新 类 Gamestats( 见 @ ), 创建 了 一 个 名 为 stats 的 实例 ( 见 @ )， 再 调用 
update_aliens() 并 添加 了 实 参 stats、screen 和 ship ( 见 @ )。 在 有 外 星人 撞 到 飞船 时 ， 我 们 将 使 
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用 这 些 实 参 来 跟踪 玩家 还 有 多 少 稻 飞船， 以 及 创建 一 群 新 的 外 星人 。 

有 外 星人 撞 到 飞船 时 ， 我 们 将 余下 的 飞船 数 减 1， 创 建 一 群 新 的 外 星人 ， 并 将 飞船 重新 放置 
到 屏幕 底 端 中 央 ( 我 们 还 将 让 游戏 暂停 一 段 时 间 , 让 玩家 在 新 外 星人 群 出 现 前 注意 到 发 生 了 碰撞 ， 
并 将 重新 创建 外 星人 群 )。 

下 面 将 实现 这 些 功 能 的 大 部 分 代码 放 到 函数 ship_hit() 中 : 


game _ functions.py 


import sys 
@ from time import sleep 


import pygame 
-- SNip-- 


def ship hit(ai settings, stats, screen, ship, aliens, bullets): 
""" 响 应 被 外 星人 撞 到 的 飞船 """ 
# 将 ships_left 减 1 
© stats.ships left -= 1 


清空 外 星人 列表 和 子弹 列表 
(3 i empty() 
bullets.empty() 


# 创建 一 群 新 的 外 星人 ， 并 将 飞船 放 到 屏幕 底 端 中 央 
@ create fleet(ai settings, screen, ship, aliens) 
ship.center ship() 


# 暂停 
(3) sleep(0.5) 


© def updatera liens (i:.settines, stats, screen, ship, aliens, bullets): 
- Snip 
# 检测 外 星人 和 飞船 碰撞 
if pygame.sprite. ale. aliens): 
ship hit(ai settings, stats, screen, ship, aliens, bullets) 


我 们 首先 从 模块 time 中 导入 了 函数 sleep() ， 以 便 使 用 它 来 让 游戏 暂停 ( 见 @ )。 新 函数 
ship_hit() 在 飞船 被 外 星人 撞 到 时 作出 响应 。 在 这 个 函数 内 部 ， 将 余下 的 飞船 数 减 1 ( 见 @ )， 然 
后 清空 编组 aliens 和 bullets ( 见 目 )。 

接 下 来 ， 我 们 创建 一 群 新 的 外 星人 ， 并 将 飞船 居中 〈 见 @ )， 稍 后 将 在 Ship 类 中 添加 方法 
center _ ship()。 最 后 ， 我 们 更 新 所 有 元 素 后 (但 在 将 修改 显示 到 屏幕 前 ) 和 暂停， 让 玩家 知道 其 

飞船 被 撞 到 了 ( 见 日 )。 屏 幕 将 暂时 停止 变化 ， 让 玩家 能 够 看 到 外 星人 撞 到 了 飞船 。 函 数 sleep() 
执行 完毕 后 ， 将 接着 执行 函数 update_screen()， 将 新 的 外 星人 和 群 绘制 到 屏幕 上 。 

我 们 还 更 新 了 update aliens() 的 定义 , 使 其 包含 形 参 stats、screen 和 bullets ( 见 @ ), 让 它 
能 够 在 调用 ship_hit() 时 传递 这 些 值 。 

下 面 是 新 方法 center_ship() ， 请 将 其 添加 到 ship.py 的 末尾 : 
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ship.py 


def center ship(self): 


"让 飞船 在 屏幕 上 居中 " 
self.center = self.screen rect.centerx 


为 让 飞船 居中 ， 我 们 将 飞船 的 属性 center 设 置 为 屏幕 中 心 的 x 坐标 ， 而 该 坐标 是 通过 属性 
screen rect 获 得 的 。 


注意 ”我 们 根本 没有 创建 多 艘 飞船 ， 在 整个 游戏 运行 期 间 ， 我 们 都 只 创建 了 一 个 飞船 实例 ， 并 
在 该 飞船 被 撞 到 时 将 其 居中 。 统 计 信 息 ships left 让 我 们 知道 飞船 是 否 用 完 。 


请 运行 这 个 游戏 ， 射 杀 几 个 外 星人 , 并 让 一 个 外 星人 撞 到 飞船 。 游 戏 暂停 后 ,将 出 现 一 群 新 
的 外 星人 ， 而 飞船 将 在 屏幕 底 端 居 中 。 


13.6.3 ”有 外 星人 到 达 屏 幕 底 端 


如 果 有 外 星人 到 达 屏 幕 底 端 , 我 们 将 像 有 外 星人 撞 到 飞船 那样 作出 响应 。 请 添加 一 个 执行 这 
项 任务 的 新 函数 ， 并 将 其 命名 为 update_aliens(): 


game _functions.py 


def check aliens bottom(ai settings, stats, screen, ship, aliens, bullets): 

"" "检查 是 否 有 外 星人 到 达 了 屏幕 底 端 """ 
screen rect = screen.get rect() 
for alien in aliens.sprites(): 

© if alien.rect.bottom >= screen rect.bottom: 

像 飞船 被 撞 到 一 样 进行 处 理 

ship hit(ai settings, stats, screen, ship, aliens, bullets) 

break 


def update aliens(ai settings, stats, screen, ship, aliens, bullets): 
-- Snip-- 
# 检查 是 否 有 外 星人 到 达 屏 幕 底 闸 
@ check aliens bottom(ai settings, stats, screen, ship, aliens, bullets) 


函数 check_aliens_bottom() 检 查 是 否 有 外 星人 到 达 了 屏幕 底 端 。 到达 屏幕 底 端 后 , 外 星人 的 
属性 rect .bottom 的 值 大 于 或 等 于 屏幕 的 属性 rect.bottom 的 值 ( 见 @ )。 如 果 有 外 星人 到 达 屏 幕 底 
端 ， 我 们 就 调用 ship_hit(); 只 要 检测 到 一 个 外 星人 到 达 屏 幕 底 端 ， 就 无 需 检 查 其 他 外 星人 ， 
此 我 们 在 调用 ship_hit() 后 退出 循环 。 

我 们 在 更 新 所 有 外 星人 的 位 置 并 检测 是 否 有 外 星人 和 飞船 发 生 碰 撞 后 调用 check_ aliens 
bottom()( 见 @ )。 现 在 ， 每 当 有 外 星人 撞 到 飞船 或 抵达 屏幕 底 端 时 ， 都 将 出 现 一 群 新 的 外 星人 。 
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13.6.4 ”游戏 结束 


现在 这 个 游戏 看 起 来 更 完整 了 , 但 它 永远 都 不 会 结束 , 只 是 ships_left 不 断 变 成 更 小 的 负数 。 
下 面 在 GameStats 中 添加 一 个 作为 标志 的 属性 game_active， 以 便 在 玩家 的 飞船 用 完 后 结束 游戏 : 


game_stats.py 


def nself, settings): 
- Snip-- 
# 游戏 刚 启 动 时 处 于 活动 状态 
self.game active = True 


现在 在 ship_hit() 中 添加 代码 ， 在 玩家 的 飞船 都 用 完 后 将 game_active 设 置 为 False: 


game _ functions.py 


def ship hit(ai settings, stats, screen, ship, aliens, bullets): 
"响应 飞船 被 外 星人 撞 到 """ 
if stats.ships left > 0: 

# 将 ships_left 减 1 
stats.ships left -= 1 
--SNip-- 
# 暂 停 一 会 儿 
sleep(0.5) 


else: 
stats.game active = False 


ship_hit() 的 大 部 分 代码 都 没 变 。 我 们 将 原来 的 所 有 代码 都 移 到 了 一 个 if 语 句 块 中 ， 这 条 if 
语句 检查 玩家 是 否 至 少 还 有 一 舟 飞 船 。 如 果 是 这 样 ， 就 创建 一 群 新 的 外 星人 ,暂停 一 会 儿 ， 再 接 
着 往 下 执行 。 如 果 玩 家 没有 飞船 了 ， 就 将 game_active 设 置 为 False。 | 


13.7 ”确定 应 运行 游戏 的 哪些 部 分 


在 alien_invasion.py 中 , 我 们 需要 确定 游戏 的 哪些 部 分 在 任何 情况 下 都 应 运行 , 哪些 部 分 仅 在 
游戏 处 于 活动 状态 时 才 运 行 : 


alien_invasion.py 


# 开始 游戏 主 循环 
while True: 
gf.check events(ai settings, screen, ship, bullets) 


if stats.game active: 
ship.update() 
gf.update bullets(ai settings, screen, ship, aliens, bullets) 
gf.update aliens(ai settings, stats, screen, ship, aliens, bullets) 


gf.update screen(ai settings, screen, ship, aliens, bullets) 
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在 主 循环 中 , 在 任何 情况 下 都 需要 调用 check_events(), 即便 游戏 处 于 非 活动 状态 时 亦 如 此 。 
例如 ， 我 们 需要 知道 玩家 是 否 按 了 Q 键 以 退出 游戏 ， 或 单 击 关闭 窗口 的 按钮 。 我 们 还 需要 不 断 更 
新 屏幕 ,以 便 在 等 待 玩家 是 否 选择 开始 新 游戏 时 能 够 修改 屏幕 。 其 他 的 函数 仅 在 游戏 处 于 活动 状 
态 时 才 需 要 调用 ， 因 为 游戏 处 于 非 活动 状态 时 ， 我 们 不 用 更 新 游戏 元 素 的 位 置 。 

现在 ， 你 运行 这 个 游戏 时 ， 它 将 在 飞船 用 完 后 停止 不 动 。 


动手 试 一 斌 


13-6 游戏 结束 : 在 为 完成 练习 13-5 而 编写 的 代码 中 ， 跟 踪 玩 家 有 多 少 次 未 将 球 接 
着 。 在 未 接着 球 的 次 数 到 达 三 次 后 ， 结 束 游 戏 。 


13.8 ”小结 


在 本 章 中 , 你 学 习 了 : 如 何在 游戏 中 添加 大 量 相同 的 元 素 ， 如 创建 一 群 外 星人 ; 如 何 使 用 髓 
套 循环 来 创建 元 素 网 格 ， 还 通过 调用 每 个 元 素 的 方法 update() 移 动 了 大 量 的 元 素 ; 如 何 控制 对 象 
在 屏幕 上 移动 的 方向 ,以 及 如 何 响应 事件 ， 如 有 外 星人 到 达 屏 幕 边缘 ; 如 何 检测 和 响应 子弹 和 外 
星人 碰撞 以 及 外 星人 和 飞船 碰撞 ; 如 何在 游戏 中 跟踪 统计 信息 ， 以 及 如 何 使 用 标志 game_active 
来 判断 游戏 是 否 结束 了 。 

在 与 这 个 项 目 相关 的 最 后 一 章 中 ， 我 们 将 添加 一 个 Play 按钮 ， 让 玩家 能 够 开始 游戏 ， 以 及 游 
戏 结束 后 再 玩 。 每 当 玩家 消灭 一 群 外 星人 后 ， 我 们 都 将 加 快 游戏 的 节奏 ， 并 添加 一 个 记分 系统 ， 
得 到 一 个 极 具 可 玩 性 的 游戏 ! 


在 本 章 中 , 我 们 将 结束 游戏 《外 星人 入 侵 》 的 开发 。 我 们 将 添加 
一 个 Play 按 钮 ， 用 于 根据 需要 启动 游戏 以 及 在 游戏 结束 后 重启 游戏 。 
我 们 还 将 修改 这 个 游戏 , 使 其 在 玩家 的 等 级 提高 时 加 快 节奏 ,并 实现 
一 个 记分 系统 。 阅 读本 章 后 ， 你 将 掌握 足够 多 的 知识 ,能 够 开始 编写 
随 玩 家 等 级 提高 而 加 大 难度 以 及 显示 得 分 的 游戏 。 


14.1 添加 Play 按钮 


在 本 节 中 ， 我们 将 添加 一 个 Play 按钮 ， 它 在 游戏 开始 前 出 现 ， 并 在 游戏 结束 后 再 次 出 现 ， 让 
玩家 能 够 开始 新 游戏 。 

当前 ,这 个 游戏 在 玩家 运行 alien_invasion.py 时 就 开始 了 ,下 面 让 游戏 一 开始 处 于 非 活 动 状态 ， 
并 提示 玩家 单 击 Play 按 钮 来 开始 游戏 。 为 此 ， 在 game_stats.py 中 输入 如 下 代码 ; 4 


game _stats.py 


def init (self, ai settings): 
"初始 化 统计 信息 """ 
self.ai settings = ai settings 
self.reset stats() 


# 让 游戏 一 开始 处 于 非 活动 状态 
self.game active = False 


def reset stats(self) 
-- Snip-- 


现在 游戏 一 开始 将 处 于 非 活动 状态 ， 等 我 们 创建 Play 按钮 后 ， 玩 家 才能 开始 游戏 。 
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14.1.1 创建 Button 类 


由 于 Pygame 没 有 内 置 创建 按钮 的 方法 ,我 们 创建 一 个 Button 类 ,用 于 创建 带 标签 的 实心 矩形 。 
你 可 以 在 游戏 中 使 用 这 些 代码 来 创建 任何 按钮 。 下 面 是 Button 类 的 第 一 部 分 , 请 将 这 个 类 保存 为 
文件 button.py: 


button.py 


import pygame.font 
class Button(): 


© def init (self, ai settings, screen, msg): 
"" "初始化 按钮 的 属性 """ 


self.screen = screen 
self.screen rect = screen.get rect() 


# 设置 按钮 的 尺寸 和 其 他 属性 

[29 self.width, self.height = 200, 50 
self.button color = (0, 255, 0) 
self.text Color = (255, 255, 255) 

(3 self.font = pygame.font.SysFont(None, 48) 


# 创建 按钮 的 rect 对 象 ， 并 使 其 居中 
@ self.rect = pygame.Rect(0, 0, self.width, self.height) 
self.rect.center = self.screen rect.center 


# 按钮 的 标签 只 需 创 建 一 次 
© self.prep msg(msg) 


首先 , 我 们 导入 了 模块 pygame.font, 它 让 Pygame 能 够 将 文本 演 染 到 屏幕 上 。, 方法 init () 
接受 参数 self， 对 象 ai _settings 和 screen， 以 及 msg， 其 中 msg 是 要 在 按钮 中 显示 的 文本 ( 见 @ )。 
我 们 设置 按钮 的 尺寸 ( 见 @ )， 然 后 通过 设置 button_color 让 按钮 的 rect 对 象 为 亮 绿 色 ， 并 通过 设 
置 text_color 计 文本 为 白色 。 

在 ( 见 @ ) 处 , 我 们 指定 使 用 什么 字体 来 演 染 文本 。 实 参 Nonei 上 Pygame 使 用 默认 字体 ， 而 48 
上 定 了 文本 的 字号 。 为 让 按钮 在 屏幕 上 居中 ， 我 们 创建 一 个 表示 按钮 的 rect 对 象 ( 见 @ )， 并 将 
其 center 属 性 设置 为 屏幕 的 center 属 性 。 

Pygame 通 过 将 你 要 显示 的 字符 串 演 染 为 图 像 来 处 理 文本 。 在 @ 处 ,我 们 调用 prep_msg() 来 处 
理 这 样 的 演 染 。 

prep_msg() 的 代码 如 下 : 


button.py 


def prep msg(self, msg): 
""" 将 msg 演 染 为 图 像 ， 并 使 其 在 按钮 上 居中 """ 
@ self.msg image = self.font.render(msg, True, self.text color, 
self.button color) 
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2 self.msg image rect = self.msg image.get rect() 
self.msg image rect.center = self.rect.center 


方法 prep_msg() 接 受 实 参 self 以 及 要 演 染 为 图 像 的 文本 ( msg )。 调 用 font.render() 将 存储 在 
msg 中 的 文本 转换 为 图 像 ， 然 后 将 该 图 像 存储 在 msg image 中 ( 见 @ ), 方法 font.render() 还 接受 
一 个 布尔 实 参 ,该 实 参 指定 开启 还 是 关闭 反 锯齿 功能 ( 反 锯 齿 让 文本 的 边缘 更 平滑 )。 余下 的 两 
个 实 参 分 别 是 文本 颜色 和 背景 色 。 我 们 启用 了 反 锯齿 功能 , 并 将 文本 的 背景 色 设 置 为 按钮 的 颜色 
(如 果 没 有 指定 背景 色 ，Pygame 将 以 透明 背景 的 方式 泻 染 文本 )。 

在 @@ 处 ， 我 们 让 文本 图 像 在 按钮 上 居中 : 根据 文本 图 像 创 建 一 个 rect， 并 将 其 center 属 性 设 
置 为 按钮 的 center 属 性 。 
最 后 ， 我 们 创建 方法 draw_button()， 通 过 调用 它 可 将 这 个 按钮 显示 到 屏幕 上 : 


二 


button.py 


def draw button(self): 
# 绘制 一 个 用 颜色 填充 的 按钮 ， 再 绘制 文本 
self.screen.fill(self.button color, self.rect) 
self.screen.blit(self.msg image, self.msg image rect) 


我 们 调用 screen.fill() 来 绘制 表示 按钮 的 矩形 ， 再 调用 screen.blit()， 并 向 它 传递 一 幅 图 
像 以 及 与 该 图 像 相 关联 的 rect 对 象 ， 从 而 在 屏幕 上 绘制 文本 图 像 。 至 此 ，Button 类 便 创建 好 了 。 


14.1.2 ”在 屏幕 上 绘制 按钮 


我 们 将 使 用 Button 类 来 创建 一 个 Play 按钮 。 鉴 于 只 需要 一 个 Play 按钮 ， 我 们 直接 在 
alien_invasion.py 中 创建 它 ， 如 下 所 示 : 


alien_invasion.py 


-- SNip-- 
from game stats import GameStats 


from button import Button 
--SNip-- 


def run game(): 
-- Snip-- 
pygame.display.set caption("Alien Invasion") 


# 创建 Play 按钮 
© play_button = Button(ai settings, screen, "Play") 


-- Snip-- 


# 开始 游戏 主 循 环 
while True: 
-- Ship-- 
@ gf.update screen(ai settings, screen, stats, ship, aliens, bullets, 
play_button) 
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run game() 


我 们 导入 Button 类 ， 并 创建 一 个 名 为 play_button 的 实例 ( 见 @ )， 然 后 我 们 将 play_button 传 
递 给 update_screen()， 以 便 能 够 在 屏幕 更 新 时 显示 按钮 ( 见 @ )。 
接 下 来 ， 修 改 update_screen() ， 以 便 在 游戏 处 于 非 活动 状态 时 显示 Play 按钮 : 


game_functions.py 


def update screen(ai settings, screen, stats, ship, aliens, bullets, 
play_button): 
""" 更 新 屏幕 上 的 图 像 ， 并 切换 到 新 屏幕 """ 
-- Snip-- 


# 如 果 游 戏 处 于 非 活 动 状 态 ， 就 绘制 Play 按 知 
if not stats.game active: 
play_button.draw_button() 


# 让 最 近 绘 制 的 屏幕 可 见 
pygame.display.flip() 


为 让 Play 按钮 位 于 其 他 所 有 屏幕 元 素 上 面 ， 我 们 在 绘制 其 他 所 有 游戏 元 素 后 再 绘制 这 个 按 
钮 ， 然 后 切换 到 新 屏幕 。 如 果 你 现在 运行 这 个 游戏 ， 将 在 屏幕 中 央 看 到 一 个 Play 按钮 ， 如 图 14-1 
所 示 。 


会 


图 14-1 游戏 处 于 非 活动 状态 时 出 现 的 Play 按钮 
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14.1.3 ”开始 游戏 


为 在 玩家 单 击 Play 按 钮 时 开始 新 游戏 ， 需 在 game_functions.py 中 添加 如 下 代码 ， 以 监视 与 这 
个 按钮 相关 的 鼠标 事件 : 


game_functions.py 


def check events(ai settings, screen, stats, play button, ship, bullets): 
"" "响应 按键 和 和 饼 标 事件 """ 
for event in pygame.event.get(): 
if event.type == pygame.QUIT: 
-- SNip-- 
elif event.type == pygame.MOUSEBUTTONDOWN: 
mouse x, mouse y = pygame.mouse.get pos() 
check_ play button(stats, play_ button, mouse x, mouse y) 


@Q@e 


def check play button(stats, play button, mouse x, mouse y): 
"i "在 玩家 单 去 Play 按 钮 时 开始 新 游戏 """ 
@ if play button.rect.collidepoint(mouse x, mouse y) : 
stats.game active = True 


我 们 修改 了 check_events() 的 定义 ,在 其 中 添加 了 形 参 stats 和 play_button。 我 们 将 使 用 stats 
来 访问 标志 game_active， 并 使 用 play_button 来 检查 玩家 是 否 单 击 了 Play 按 钮 。 

无 论 玩 家 单 击 屏幕 的 什么 地 方 ，Pygame 都 将 检测 到 一 个 MOUSEBUTTONDOWN 事 件 ( 见 @ ), 但 我 
们 只 想 让 这 个 游戏 在 玩家 用 鼠标 单 击 Play 按 钮 时 作出 响应 。 为 此 ， 我 们 使 用 了 pygame.mouse. 
get_pos()， 它 返回 一 个 元 组 ， 其 中 包含 玩家 单 击 时 鼠标 的 zx 和) 坐标 ( 见 @ )。 我 们 将 这 些 值 传递 
给 函数 check_play_button()( 见 @ )， 而 这 个 函数 使 用 collidepoint() 检 查 鼠 标 单 击 位 置 是 否 在 
Play 按钮 的 rect 内 〈 见 @ )。 如 果 是 这 样 的 ， 我 们 就 将 game_active 设 置 为 True， 让 游戏 就 此 开始 ! 

在 alien invasion.py 中 调用 check_events() ， 需 要 传递 另外 两 个 实 参 stats 和 play 
button : 


alien_invasion.py 


# 开始 游戏 主 循环 
while True: 
gf.check events(ai settings, screen, stats, play button, ship, 
bullets) 
-- Snip-- 


至 此 ， 你 应 该 能 够 开始 这 个 游戏 了 。 游 戏 结束 时 ，game_active 应 为 False， 并 重新 显示 Play 
按钮 。 


14.1.4” 重 置 游戏 


前 面 编写 的 代码 只 处 理 了 玩家 第 一 次 单 击 Play 按钮 的 情况 ， 而 没有 处 理 游 戏 结束 的 情况 ， 
为 没有 重 置 导 致 游戏 结束 的 条 件 。 
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为 在 玩家 每 次 单 击 Play 按钮 时 都 重 置 游戏 ， 需 要 重 置 统计 信息 、 删 除 现 有 的 外 星人 和 子弹 、 
创建 一 群 新 的 外 星人 ， 并 让 飞船 居中 ， 如 下 所 示 : 


game functions.py 


def check play button(ai settings, screen, stats, play button, ship, aliens, 
bullets, mouse x, mouse y): 
"在 玩家 单 击 Play 按 钮 时 开始 新 游戏 """ 
play_button.rect.collidepoint(mouse x, mouse y): 
# 重 置 游戏 统计 信息 
@ stats.reset stats() 
stats.game active = True 


| 这 


i 


# 清空 外 星人 列表 和 子弹 列表 
2 aliens.empty() 
bullets.empty() 


# 创建 一 群 新 的 外 星人 ， 并 让 飞船 居中 
create fleet(ai settings, screen, ship, aliens) 
ship.center ship() 


我 们 更 新 了 check_play_button() 的 定义 ， 使 其 能 够 访问 ai _settings、stats、ship、aliens 


和 bullets。 为 重 置 在 游戏 期 间 发 生 了 变化 的 设置 以 及 刷新 游戏 的 视觉 元 素 ， 它 需要 这 些 对 象 。 
在 @ 处 ,我 们 重 置 了 游戏 统计 信息 ， 给 玩家 提供 了 三 艘 新 飞船 。 接 下 来 ,我 们 将 game_active 
设置 为 True ( 这样 , 这 个 函数 的 代码 执行 完毕 后 , 游戏 就 会 开始 ), 清空 编组 aliens 和 bullets ( 见 
@ ), 创建 一 群 新 的 外 星人 ， 并 将 飞船 居中 ( 见 @ )。 
check_events() 的 定义 需要 修改 ,调用 check_play_button() 的 代码 亦 如 此 : 


game _functions.py 


def check events(ai settings, screen, stats, play button, ship, aliens, 
bullets): 


""" 响 应 按键 和 和 饼 标 事件 """ 
for event in pygame.event.get(): 
if event.type == pygame.QUIT: 
-- Snip-- 
elif event.type == pygame.MOUSEBUTTONDOWN: 
mouse x, mouse y = pygame.mouse.get pos() 
check play button(ai settings, screen, stats, play_ button, ship, 
aliens, bullets, mouse x, mouse y) 


check_events() 的 定义 需要 形 参 aliens， 以 便 将 它 传递 给 check_play_button()。 接 下 来 ， 我 
们 修改 了 调用 check_play_button() 的 代码 ， 以 将 合适 的 实 参 传递 给 它 ( 见 @ )。 
下 面 来 修改 alien invasion.py 中 调用 check_events() 的 代码 ， 以 将 实 参 aliens 传 递 给 它 : 


alien_invasion.py 


# 开始 游戏 主 循环 
while True: 
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gf.check events(ai settings, screen, stats, play button, ship, 
aliens, bullets) 
-- Snip-- 


现在 , 每 当 玩家 单 击 Play 按 钮 时 , 这 个 游戏 都 将 正确 地 重 置 , 让 玩家 想 玩 多 少 次 就 玩 多 少 次 ! 


14.1.5 将 Play 按钮 切换 到 非 活 动 状态 


当前 ,Play 按 钮 存在 一 个 问题 , 那 就 是 即便 Play 按 钮 不 可 见 , 玩家 单 击 其 原来 所 在 的 区 域 时 ， 
游戏 依然 会 作出 响应 。 游 戏 开 始 后 ， 如 果 玩 家 不 小 心 单 击 了 Play 按钮 原来 所 处 的 区 域 ， 游 戏 将 重 
新 开始 ! 
为 修复 这 个 问题 ， 可 让 游戏 仅 在 game_active 为 False 时 才 开 始 : 


game_functions.py 


def check play button(ai settings, screen, stats, play button, ship, aliens, 
bullets, mouse x, mouse y): 
""" 玩 家 单 击 Play 按 钮 时 开始 新 游戏 """ 


© button clicked = play button.rect.collidepoint (mouse x, mouse y) 
© if button clicked and not stats.game active: 

# 重 置 游 戏 统计 信息 

=- Ship-- 


标志 button_clicked 的 值 为 True 或 False ( 见 @ ), 仅 当 玩家 单 击 了 Play 按 钮 且 游 戏 当 前 处 于 非 活 
动 状态 时 ， 游 戏 才 重新 开始 ( 见 @ )。 为 测试 这 种 行为 ， 可 开始 新 游戏 ， 并 不 断 地 单 击 Play 按 钮 原 
来 所 在 的 区 域 。 如 果 一 切 都 像 预 期 的 那样 工作 ， 单 击 Play 按 钮 原来 所 处 的 区 域 应 该 没有 任何 影响 。 
14.1.6 ”隐藏 光标 


为 让 玩家 能 够 开始 游戏 ,我 们 要 让 光标 可 见 ， 但 游戏 开始 后 ， 光 标 只 会 添乱 。 为 修复 这 种 问 
题 ， 我 们 在 游戏 处 于 活动 状态 时 让 光标 不 可 见 : 4 


game_functions.py 


def check play button(ai settings, screen, stats, play button, ship, aliens, 

bullets, mouse x, mouse y): 

""" 在 玩家 单 击 Play 按 钮 时 开始 新 游戏 """ 

button clicked = play button.rect.collidepoint(mouse x, mouse y) 

if button clicked and not stats.game active: 
# 隐藏 光标 
pygame.mouse.set visible(False) 
-- Snip-- 


通过 向 set_visible() 传 递 False， 让 Pygame 在 光标 位 于 游戏 窗口 内 时 将 其 隐藏 起 来 。 
游戏 结束 后 ， 我 们 将 重新 显示 光标 ， 让 玩家 能 够 单 击 Play 按钮 来 开始 新 游戏 。 相 关 的 代码 
如 下 : 
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game_functions.py 


def ship hit(ai settings, screen, stats, ship, aliens, bullets) 


和 Te A 
Ss 外 星人 撞 到 


s left > 0: 


else: 


stats.game active = False 
pygame.mouse. set visible(True) 


在 ship_hit() 中 ， 我 们 在 游戏 进入 非 活动 状态 后 ， 立 即 让 光标 可 见 。 关 注 这 样 的 细节 让 游戏 
显得 更 专业 ， 也 让 玩家 能 够 专注 于 玩 游戏 而 不 是 费力 搞 明白 用 户 界面 。 


动手 试 一 斌 
14-1 按 P 开始 新 游戏 : 鉴于 游戏 《外 星人 入 侵 》 使 用 键盘 来 控制 飞船 ， 最 好 让 玩 
家 也 能 够 通过 按键 来 开始 游戏 。 请 添加 让 玩家 在 按 P 时 开始 游戏 的 代码 。 也许 这 样 做 会 
有 所 帮助 : 将 check_play_button() 的 一 些 代 码 提 取出 来 ， 放 到 一 个 名 为 start_game() 


的 函数 中 ， 并 在 check play button() 和 check keydown events() 中 调用 这 个 函数 。 

14-2 射击 练习 : 创建 一 个 答 形 ， 它 在 屏幕 右边 缘 以 固定 的 速度 上 下 移动 。 然 后 ， 
在 屏幕 左边 缘 创 建 一 般 飞 船 ， 玩 家 可 上 下 移动 该 飞船 ， 并 射击 前 述 矩 形 目 标 。 添加 一 个 
用 于 开始 游戏 的 Play 按钮 ， 在 玩家 三 次 未 击 中 目标 时 结束 游戏 ， 并 重新 显示 Play 按钮 ， 
让 玩家 能 够 通过 单 击 该 按钮 来 重新 开始 游戏 。 


14.2 ”提高 等 级 


当前 ， 将 整 群 外 星人 都 消灭 干净 后 ， 玩 家 将 提高 一 个 等 级 ,但 游戏 的 难度 并 没有 变 。 下 面 
来 增加 一 点 趣味 性 ， 每 当 玩家 将 屏幕 上 的 外 星人 都 消灭 干净 后 ， 加 快 游戏 的 节奏 ， 让 游戏 玩 起 
来 更 难 。 

14.2.1 修改 速度 设置 


我 们 首先 重新 组 织 Settings 类 ， 将 游戏 设置 划分 成 静态 的 和 动态 的 两 组 。 对 于 随 着 游戏 进行 
而 变化 的 设置 ， 我 们 还 确保 它们 在 开始 新 游戏 时 被 重 置 。settings.py 的 方法 _init _() 如 下 : 


settings.py 


def init (self): 
""" 初 始 化 游戏 的 静态 设置 """ 
# 屏幕 设置 


self.screen width = 1200 


self.screen height = 800 
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self.bg color = (230, 230，230) 
# 飞船 设置 
self.ship limit = 3 


# 子弹 设置 
self.bullet width = 3 
self.bullet height = 15 
self.bullet color = 60，60，60 
self.bullets allowed = 3 


# 外 星人 设置 
self.fleet drop speed = 10 


# 以 什么 样 的 速度 加 快 游戏 节奏 
© self.speedup scale = 1.1 


© self.initialize dynamic settings() 


我 们 依然 在 ”init () 中 初始 化 静态 设置 。 在 @ 处 ,我们 添加 了 设置 speedup_scale， 用 于 控 
制 游戏 节奏 的 加 快速 度 : 2 表示 玩家 每 提高 一 个 等 级 ,游戏 的 节奏 就 翻 倍 ; 1 表示 游戏 节奏 始终 不 
变 。 将 其 设置 为 1.1 能 够 将 游戏 节奏 提高 到 够 快 ， 让 游戏 既 有 难度 ， 又 并 非 不 可 完成 。 最 后 ,我 
们 调用 initialize_dynamic_settings()， 以 初始 化 随 游 戏 进行 而 变化 的 属性 ( 见 @ )。 

initialize dynamic settings() 的 代码 如 下 : 


settings.py 


def initialize dynamic settings(self): 
""" 初 始 化 随 游戏 进行 而 变化 的 设置 """ 
self.ship speed factor = 1.5 
self.bullet speed factor = 3 
self.alien speed factor = 1 


# fleet direction 为 1 表示 向 右 ; 为 -1 表示 向 左 
f.fleet direction = 1 


an 
om 
i 


这 个 方法 设置 了 飞船 、 子 弹 和 外 星人 的 初始 速度 。 随 游戏 的 进行 ,我们 将 提高 这 些 速 度 ， 而 
每 当 玩家 开始 新 游戏 时 ,都 将 重 置 这 些 速 度 。 在 这 个 方法 中 ,我 们 还 设置 了 fleet_direction, 使 
得 游戏 刚 开 始 时 , 外 星人 总 是 向 右 移 动 。 每 当 玩 家 提高 一 个 等 级 时 , 我 们 都 使 用 increase_speed() 
来 提高 飞船 、 子 弹 和 外 星人 的 速度 : 


settings.py 


def increase speed(self): 
""" 提 高 速度 设置 "" 
self.ship speed factor *= self.speedup scale 
self.bullet speed factor *= self.speedup scale 
self.alien speed factor *= self.speedup scale 
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为 提高 这 些 游 戏 元 素 的 速度 ， 我 们 将 每 个 速度 设置 都 乘 以 speedup_scale 的 值 。 
在 check_ bullet alien collisions() 中 , 我 们 在 整 群 外 星人 都 被 消灭 后 调用 increase_speed() 
来 加 快 游戏 的 节奏 ， 再 创建 一 群 新 的 外 星人 : 


game functions.py 


def check bullet alien collisions(ai settings, screen, ship, aliens, bullets): 
-- SNip-- 
if len(aliens) == 0: 
# 删除 现 有 的 子弹 ， 加 快 游戏 节奏 ， 并 创建 一 群 新 的 外 星人 
bullets.empty() 
ai settings.increase speed() 
create fleet(ai settings, screen, ship, aliens) 


通过 修改 速度 设置 ship speed factor、alien speed factor 和 bullet speed factor 的 值 ， 足 
以 加 快 整个 游戏 的 节奏 ! 
14.2.2 ” 重 置 速度 


每 当 玩 家 开始 新 游戏 时 , 我们 都 需要 将 发 生 了 变化 的 设置 重 置 为 初始 值 , 否则 新 游戏 开始 时 ， 
速度 设置 将 是 前 一 次 游戏 增加 了 的 值 : 


game _ functions.py 


def check play button(ai settings, screen, stats, play button, ship, aliens, 
bullets, mouse x, mouse y): 
""" 在 玩家 单 击 Play 按 钮 时 开始 新 游戏 """ 
button clicked = play button.rect.collidepoint(mouse x, mouse y) 
if button clicked and not stats.game active: 
# 重 置 游戏 设置 
ai settings.initialize dynamic settings() 
# 隐藏 光标 
me.mouse.set visible(False) 


-~ SNID== 


现在 , 游戏 《外 星人 入 侵 》 玩 起 来 更 有 趣 ， 也 更 有 挑战 性 。 每 当 玩 家 将 屏幕 上 的 外 星人 消灭 
干净 后 ， 游 戏 都 将 加 快 节 奏 ， 因 此 难度 会 更 大 些 。 如 果 游 戏 的 难度 提高 得 太 快 ， 可 降低 
settings.speedup_scale 的 值 ， 如 果 游 戏 的 挑战 性 不 足 ， 可 稍微 提高 这 个 设置 的 值 。 找 出 这 个 设 
置 的 最 佳 值 ， 让 难度 的 提高 速度 相对 合理 : 一 开始 的 几 群 外 星人 很 容易 消灭 干净 ; 接 下 来 的 几 群 
消灭 起 来 有 一 定 难度 ， 但 也 不 是 不 可 能 ; 而 要 将 更 靠 后 的 外 星人 群 消灭 干净 几乎 不 可 能 。 


动手 试 一 斌 


14-3 有 一 定 难 度 的 射击 练习 : 以 你 为 完成 练习 14-2 而 做 的 工作 为 基础 ， 让 标 靶 的 
移动 速度 随 游戏 进行 而 加 快 ， 并 在 玩家 单 击 Play 按钮 时 将 其 重 置 为 初始 值 。 
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14.3 ”记分 


下 面 来 实现 一 个 记分 系统 ， 以 实时 地 跟踪 玩家 的 得 分 , 并 显示 最 高 得 分 、 当 前 等 级 和 余下 的 
飞船 数 。 
得 分 是 游戏 的 一 项 统计 信息 ， 因 此 我 们 在 camestats 中 添加 一 个 score 


game_stats.py 


el 


class GameStats(): 
-- Ship-- 
def reset stats(self): 
"" "初始化 随 游 戏 进行 可 能 变化 的 统计 信息 """ 
self.ships left = self.ai settings.ship limit 
self.score = 0 


为 在 每 次 开始 游戏 时 都 重 置 得 分 ， 我 们 在 reset_stats() 而 不 是 _init () 中 初始 化 score。 


14.3.1 显示 得 分 

为 在 屏幕 上 显示 得 分 ， 我 们 首先 创建 一 个 新 类 Scoreboard。 就 当前 而 言 ， 这 个 类 只 显示 当前 
得 分 , 但 后 面 我 们 也 将 使 用 它 来 显示 最 高 得 分 、 等 级 和 余下 的 飞船 数 。 下 面 是 这 个 类 的 前 半 部 分 ， 
它 被 保存 为 文件 scoreboard.py: 


Scoreboard.py 


import pygame.font 


class Scoreboard(): 
mu" 显示 得 分 信息 的 类 """ 


© def init (self, ai settings, screen, stats): 
"" "初始化 显示 得 分 涉及 的 属性 """ 

self.screen = screen 

self.screen rect = screen.get rect() 
self.ai settings = ai settings 

self.stats = stats 


# 显示 得 分 信息 时 使 用 的 字体 设置 
@ self.text Color = (30, 30, 30) 
[3) self.font = pygame.font.SysFont(None, 48) 


# 准备 初始 得 分 图 像 
9 self.prep score() 


由 于 Scoreboard 在 屏幕 上 显示 文本 ， 因 此 我 们 首先 导入 模块 pygame.font。 接 下 来 ， 我 们 在 
_ init () 中 包含 形 参 ai settings 、screen 和 stats, 让 它 能 够 报告 我 们 跟踪 的 值 ( 见 @ )。 然后， 
我 们 设置 文本 颜色 ( 见 @ ) 并 实例 化 一 个 字体 对 象 ( 见 @ )。 

为 将 要 显示 的 文本 转换 为 图 像 ， 我 们 调用 了 prep_score()( 见 @ )， 其 定义 如 下 : 
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scoreboard.py 


def prep score(self): 
""" 将 得 分 转换 为 一 幅 泻 染 的 图 像 """ 
score str = str(self.stats.score) 
self.score image = self.font.render(score str, True, self.text color, 
self.ai settings.bg color) 


®©® 


# 将 得 分 放 在 屏幕 右上 角 

self.score rect = self.score image.get rect() 
self.score rect.right = self.screen rect.right - 20 
self.score rect.top = 20 


OO 


在 prep_score() 中 ， 我 们 首先 将 数字 值 stats .score 转 换 为 字符 串 ( 见 @ )， 表 将 这 个 字符 串 
传递 给 创建 图 像 的 render()( 见 @ )。 为 在 屏幕 上 清晰 地 显示 得 分 , 我 们 向 render() 传 递 了 屏幕 背 
景色 ， 以 及 文本 颜色 。 

我 们 将 得 分 放 在 屏幕 右上 角 , 并 在 得 分 增 大 导致 这 个 数字 更 宽 时 让 它 向 左 延 伸 。 为 确保 得 分 
始终 锚 定 在 屏幕 右边 , 我 们 创建 了 一 个 名 为 score rect 的 rect ( 见 @ ), 让 其 右边 缘 与 屏幕 右边 缘 
相距 20 像 素 ( 见 @ )， 并 让 其 上 边缘 与 屏幕 上 边缘 也 相距 20 像 素 ( 见 @ )。 

最 后 ， 我 们 创建 方法 show_score()， 用 于 显示 演 染 好 的 得 分 图 像 : 


scoreboard.py 


def show score(self): 
mn 在 屏幕 上 显示 得 分 """ 
self.screen.blit(self.score image, self.score rect) 


这 个 方法 将 得 分 图 像 显 示 到 屏幕 上 ， 并 将 其 放 在 score_rect 指 定 的 位 置 。 
14.3.2 ”创建 记分 牌 


为 显示 得 分 ， 我们 在 alien_invasion.py 中 创建 一 个 Scoreboard 实 例 : 


alien_invasion.py 


-- SNnip-- 

from game stats import GameStats 

from scoreboard import Scoreboard 

-- Snip-- 

def run game(): 
-- SNip-- 
# 创建 存储 游戏 统计 信息 的 实例 ， 并 创建 记分 牌 
stats = GameStats(ai settings) 

@ sb = Scoreboard(ai settings, screen, stats) 


# 开始 游戏 主 循环 
while True: 
-- Snip-- 
[29 gf.update screen(ai settings, screen, stats, sb, ship, aliens, 
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bullets, play_button) 
run_ game() 


我 们 导入 新 创建 的 类 Scoreboard, 并 在 创建 实例 stats 后 创建 了 一 个 名 为 sb 的 Scoreboard 实 例 
( 见 @ )。 接 下 来 ， 我们 将 sb 传递 给 update_screen()， 让 它 能 够 在 屏幕 上 显示 得 分 ( 见 @ )。 
为 显示 得 分 ， 将 update_screen() 修 改 成 下 面 这 样 : 


game _functions.py 


def update screen(ai settings, screen, stats, sb, ship, aliens, bullets, 
play_button): 
--SNnip-- 
# 显示 得 分 
sb.show score() 


# 如 果 游 戏 处 于 非 活 动 状态 ,就 显示 Play 按 馈 
if not stats.game active: 
play_button.draw button() 


# 让 最 近 绘制 的 屏幕 可 见 
pygame.display.flip() 
我 们 在 update_screen() 的 形 参 列表 中 添加 了 sb， 并 在 绘制 Play 按 钮 前 调用 show_score。 
如 果 现 在 运行 这 个 游戏 ， 你 将 在 屏幕 右上 角 看 到 0 ( 当前 ， 我 们 只 想 在 进一步 开发 记分 系统 
前 确认 得 分 出 现在 正确 的 地 方 )。 图 14-2 显 示 了 游戏 开始 前 的 得 分 。 


会 


图 14-2 ”得 分 出 现在 屏幕 右上 角 


下 面 来 指定 每 个 外 星人 值 多 少 点 ! 
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14.3.3 ”在 外 星人 被 消灭 时 更 新 得 分 


为 在 屏幕 上 实时 地 显示 得 分 ， 每 当 有 外 星人 被 击 中 时 ， 我 们 都 更 新 stats.score 的 值 ， 再 调 
用 prep_score() 更 新 得 分 图 像 。 但 在 此 之 前 ， 我 们 需要 指定 玩家 每 击落 一 个 外 星人 都 将 得 到 多 少 


个 点 : 


settings.py 


def initialize dynamic settings(self) 
-- Snip-- 


# 记分 
self.alien points = 50 
随 着 游戏 的 进行 , 我 们 将 提高 每 个 外 星人 值 的 点 数 。 为 确保 每 次 开始 新 游戏 时 这 个 值 都 会 被 
重 置 ， 我 们 在 initialize dynamic settings() 中 设置 它 。 
在 check _ bullet alien collisions() 中 ， 每 当 有 外 星人 被 击落 时 ， 都 更 新 得 分 : 


game _functions.py 


def check bullet alien collisions(ai settings, screen, stats, sb, ship, 
aliens, bullets): 
和 外 星人 发 生 碰撞 ”” 


子弹 和 外 星人 
collisions = pygame.sprite.groupcollide(bullets, aliens, True, True) 


if collisions: 
© stats.score += ai settings.alien points 
sb.prep_score() 


号 坊 ge 
SNnip 


我 们 更 新 check_bullet alien collisions() 的 定义 , 在 其 中 包含 了 形 参 stats 和 sb, 让 它 能 够 
更 新 得 分 和 记分 牌 。 有 子弹 撞 到 外 星人 时 ，Pygame 返 回 一 个 字典 ( collisions )。 我 们 检查 这 个 
字典 是 否 存在 ， 如 果 存 在 ， 就 将 得 分 加 上 一 个 外 星人 值 的 点 数 ( 见 @ )。 接 下 来 ,我 们 调用 
prep_score() 来 创建 一 幅 显示 最 新 得 分 的 新 图 像 。 

我 们 需要 修改 update_bullets() ， 确 保 在 函数 之 间 传 递 合 适 的 实 参 : 


game functions.py 


def update bullets(ai settings, screen, stats, sb, ship, aliens, bullets): 


""" 更 新 子弹 的 位 置 ， 并 删除 已 消失 的 子弹 """ 


-- Snip-- 


check bullet alien collisions(ai settings, screen, stats, sb, ship, 
aliens, bullets) 


在 update_bullets() 的 定义 中 ， 需 要 新 增 形 参 stats 和 sb ， 而 调用 check_bullet alien_ 
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collisions() 时 ， 也 需要 传递 实 参 stats 和 sb。 
我 们 还 需要 修改 主 while 循 环 中 调用 update_bullets() 的 代码 : 


alien_invasion.py 


# 开始 游戏 主 循环 
while True: 
gf.check events(ai settings, screen, stats, play button, ship, 
aliens, bullets) 
if stats.game active: 
ship.update() 
gf.update bullets(ai settings, screen, stats, sb, ship, aliens, 
bullets) 


-- Ship-- 


调用 update_bullets() 时 ,需要 传递 实 参 stats 和 sb。 
如 果 你 现在 运行 这 个 游戏 ， 得 分 将 不 断 增 加 ! 


14.3.4 将 消灭 的 每 个 外 星人 的 点 数 都 计 入 得 分 


当前 , 我 们 的 代码 可 能 遗漏 了 一 些 被 消灭 的 外 星人 。 例如 ,如果 在 一 次 循环 中 有 两 颗 子 弹射 
中 了 外 星人 , 或 者 因子 弹 更 宽 而 同时 击 中 了 多 个 外 星人 , 玩家 将 只 能 得 到 一 个 被 消灭 的 外 星人 的 
点 数 。 为 修复 这 种 问题 ， 我 们 来 调整 检测 子弹 和 外 星人 碰撞 的 方式 。 

在 check_bullet_alien_collisions() 中 ， 与 外 星人 碰撞 的 子弹 都 是 字典 collisions 中 的 一 个 
键 ; 而 与 每 颗 子 弹 相 关 的 值 都 是 一 个 列表 ， 其 中 包含 该 子弹 撞 到 的 外 星人 。 我 们 遍历 字典 
collisions， 确 保 将 消灭 的 每 个 外 星人 的 点 数 都 记 和 得分: 


game_functions.py 


def check bullet alien collisions(ai settings, screen, stats, sb, ship, 
aliens, bullets): 
-- Ship-- 
if collisions: 
© for aliens in collisions.values() 

stats.score += ai settings.alien points * len(aliens) 
sb.prep score() 

-- Ship-- 


如 果 字 典 collisions 存 在 ， 我 们 就 遍历 其 中 的 所 有 值 。 别 忘 了 ， 每 个 值 都 是 一 个 列表 ， 包 含 
被 同一 颗 子弹 击 中 的 所 有 外 星人 。 对 于 每 个 列表 , 都 将 一 个 外 星人 的 点 数 乘 以 其 中 包含 的 外 星人 
数量 ， 并 将 结果 加 入 到 当前 得 分 中 。 为 测试 这 一 点 ， 请 将 子弹 宽度 改 为 300 像 素 ， 并 核实 你 得 到 
了 更 宽 的 子弹 击 中 的 每 个 外 星人 的 点 数 ， 再 将 子弹 宽度 恢复 到 正常 值 。 


14.3.5 “提高 点 数 
玩家 每 提高 一 个 等 级 ， 游 戏 都 变 得 更 难 ， 因 此 处 于 较 高 的 等 级 时 ， 外 星人 的 点 数 应 更 高 。 为 
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实现 这 种 功能 ,我们 添加 一 些 代码 ， 以 在 游戏 节奏 加 快 时 提高 点 数 : 


settings.py 


class Settings(): 
""" 存 储 游戏 《外 星人 入 侵 》 的 所 有 设置 的 类 """ 


def init (self): 
-- SNip-- 
# 加 快 游戏 节奏 的 速度 
self.speedup scale = 1.1 
# 外 星人 点 数 的 提高 速度 
© self.score scale = 1.5 


self.initialize dynamic settings() 


def increase speed(self): 
mm 提高 速度 设置 和 外 星人 点 数 """ 


self.ship speed factor *= self.speedup scale 
self.bullet speed factor *= self.speedup scale 
self.alien speed factor *= self.speedup scale 

2 self.alien points = int(self.alien points * self.score scale) 


我 们 定义 了 点 数 提高 的 速度 ， 并 称 之 为 score_scale ( 见 @ ),。 很 小 的 节奏 加 快速 度 (1.1 ) 让 
游戏 很 快 就 变 得 极 具 挑战 性 , 但 为 让 记分 发 生 显著 的 变化 , 需要 将 点 数 的 提高 速度 设置 为 更 大 的 
值 (1.5 )。 现 在 ,我 们 在 加 快 游戏 节奏 的 同时 ， 提 高 了 每 个 外 星人 的 点 数 。 为 让 点 数 为 整数 ， 我 
们 使 用 了 函数 int()。 

为 显示 外 星人 的 点 数 ， 我 们 在 Settings 的 方法 increase_speed() 中 添加 了 一 条 print 语 句 : 


settings.py 


def increase speed(self): 
-- Snip-- 
self.alien points = int(self.alien points * self.score scale) 
print(self.alien points) 


现在 每 当 提 高 一 个 等 级 时 ， 你 都 会 在 终端 窗口 看 到 新 的 点 数值 。 
注意 ”确认 点 数 在 不 断 增 加 后 ,一 定 要 删除 这 条 print 语 句 ， 否 则 它 可 能 会 影响 游戏 的 性 能 以 及 


分 散 玩家 的 注意 力 。 


14.3.6 ”将 得 分 圆 整 


大 多 数 街机 风格 的 射击 游戏 都 将 得 分 显示 为 10 的 整数 倍 , 下面 让 我 们 的 记分 系统 遵循 这 个 原 
则 。 我 们 还 将 设置 得 分 的 格式 ， 在 大 数字 中 添加 用 逗号 表示 的 千 位 分 隔 符 。 我 们 在 Scoreboard 中 
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执行 这 种 修改 : 


Scoreboard.py 


def prep score(self): 
""" 将 得 分 转换 为 演 染 的 图 像 """ 
© rounded score = int(round(self.stats.score, -1)) 
© score str = "{:,}".format(rounded score) 
self.score image = self.font.render(score str, True, self.text color, 
self.ai settings.bg color) 
--SNnip-- 


函数 round() 通 常 让 小 数 精确 到 小 数 点 后 多 少 位 ， 其 中 小 数位 数 是 由 第 二 个 实 参 指定 的 。 然 
而 ， 如 果 将 第 二 个 实 参 指定 为 负数 ，round() 将 圆 整 到 最 近 的 10、100、1000 等 整数 倍 。@ 处 的 代 
码 计 Python 将 stats.score 的 值 圆 整 到 最 近 的 10 的 整数 倍 ， 并 将 结果 存储 到 rounded_score 中 。 


注意 在 Python 2.7 中 ，round() 总 是 返回 一 个 小 数值 ， 因 此 我 们 使 用 int() 来 确保 报告 的 得 分 为 
整数 。 如 果 你 使 用 的 是 Python 3， 可 省 略 对 int() 的 调用 。 


@@ 处 使 用 了 一 个 字符 串 格式 设置 指令 ， 它 让 Python 将 数值 转换 为 字符 串 时 在 其 中 搬 人 逗号 ， 
例如 ， 输 出 1,000,000 而 不 是 1000000。 如 果 你 现在 运行 这 个 游戏 ， 看 到 的 将 是 10 的 整数 倍 的 整洁 
得 分 ， 即 便 得 分 很 高 亦 如 此 ， 如 图 14-3 所 示 。 


3,589,780 


图 14-3 ”得 分 为 10 的 整数 倍 ， 并 将 逗号 用 作 千 分 位 分 隔 符 
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14.3.7 ”最 高 得 分 
每 个 玩家 都 想 超过 游戏 的 最 高 得 分 记录 。 下 面 来 跟踪 并 显示 最 高 得 分 , 给 玩家 提供 要 超越 的 
目标 。 我 们 将 最 高 得 分 存储 在 GameSstats 中 : 


game _stats.py 


def init (self, ai settings) : 
-- Snip-- 
# 在 任何 情况 下 都 不 应 重 置 最 高 得 分 
self.high score = 0 


鉴于 在 任何 情况 下 都 不 会 重 置 最 高 得 分 , 我 们 在 _init _() 中 而 不 是 reset_stats() 中 初始 化 
high score。 


下 面 来 修改 Scoreboard 以 显示 最 高 得 分 。 先 来 修改 方法 _init _(): 


scoreboard.py 


def init (self, ai settings, screen, stats): 
-- Snip-- 
# 准备 包含 最 高 得 分 和 当前 得 分 的 图 像 
self.prep score() 
@ self.prep high score() 


最 高 得 分 将 与 当前 得 分 分 开 显示 , 因此 我 们 需要 编写 一 个 新 方法 prep_high_score(), 用 于 准 
备 包 含 最 高 得 分 的 图 像 ( 见 @ )。 
方法 prep_high_score() 的 代码 如 下 : 


scoreboard.py 


def prep high score(self): 
""" 将 最 高 得 分 转换 为 演 染 的 图 像 """ 
@ high score = int(round(self.stats.high score, -1)) 
@ high score str = "{:,}".format(high score) 
3 self.high score image = self.font.render(high score str, True, 
self.text color, self.ai settings.bg color) 
# 将 最 高 得 分 放 在 屏幕 项 部 中 央 
self.high score rect = self.high score image.get rect() 
4 self.high score rect.centerx = self.screen rect.centerx 
© self.high score rect.top = self.score rect.top 
我 们 将 最 高 得 分 圆 整 到 最 近 的 10 的 整数 倍 ( 见 @ ), 并 添加 了 用 逗号 表示 的 千 分 位 分 隔 符 ( 见 
@ )。 然 后 ， 我 们 根据 最 高 得 分 生成 一 幅 图 像 ( 见 @ )， 使 其 水 平 居 中 ( 见 @ )， 并 将 其 top 属 性 设 


置 为 当前 得 分 图 像 的 top 属 性 ( 见 @ )。 
现在 , 方法 show_score() 需 要 在 屏幕 右上 角 显 示 当 前 得 分 , 并 在 屏幕 顶部 中 央 显 示 最 高 得 分 : 
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scoreboard.py 


def show score(self): 
""" 在 屏幕 上 显示 当前 得 分 和 最 高 得 分 """ 
self.screen.blit(self.score image, self.score rect) 
self.screen.blit(self.high score image, self.high score rect) 


为 检查 是 否 诞 生 了 新 的 最 高 得 分 ， 我 们 在 game_functions.py 中 添加 一 个 新 函数 check_high_ 


score(): 


game _ functions.py 


def check high score(stats, sb): 
"" "检查 是 否 谴 生 了 新 的 最 高 得 分 """ 
© if stats.score > stats.high score: 
stats.high score = stats.score 
sb.prep high score() 


函数 check_high_score() 包 含 两 个 形 参 : stats 和 sb。 它 使 用 stats 来 比较 当前 得 分 和 最 高 得 
分 ， 并 在 必要 时 使 用 sb 来 修改 最 高 得 分 图 像 。 在 @ 人 处 ,我 们 比较 当前 得 分 和 最 高 得 分 ， 如 果 当 前 
得 分 更 高 ， 就 更 新 high_score 的 值 ， 并 调用 prep_high_score() 来 更 新 包含 最 高 得 分 的 图 像 。 

在 check pullet alien collisions() 中 ， 每 当 有 外 星人 被 消灭 ， 都 需要 在 更 新 得 分 后 调用 
check high score(): 


game_functions.py 


def check _ bullet alien collisions(ai settings, screen, stats, sb, ship, 
aliens, bullets): 
-- Snip-- 
if collisions: 
for aliens in collisions.values(): 
stats.score += ai settings.alien points * len(aliens) 
sb.prep score() 
check high score(stats, sb) 
-- Ship-- 


字典 collisions 存 在 时 ,我们 根据 消灭 了 多 少 外 星人 来 更 新 得 分 ， 再 调用 check high_ 
score()s 
第 一 次 玩 这 款 游 戏 时 ， 当 前 得 分 就 是 最 高 得 分 ， 因此 两 个 地 方 显 示 的 都 是 当前 得 分 。 但 再 次 
开始 这 个 游戏 时 ， 最 高 得 分 出 现在 中 央 ， 而 当前 得 分 出 现在 右边 ， 如 图 14-4 所 示 。 
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图 14-4 ”最 高 得 分 显示 在 屏幕 顶部 中 央 


14.3.8 ”显示 等 级 


为 在 游戏 中 显示 玩家 的 等 级 ， 首 先 需要 在 GameStats 中 添加 一 个 表示 当前 等 级 的 属性 。 为 确 
保 每 次 开始 新 游戏 时 都 重 置 等 级 ， 在 reset_stats() 中 初始 化 它 : 


game _stats.py 


def reset stats(self): 
"" "初始化 随 游 戏 进行 可 能 变化 的 统计 信息 "" 
self.ships left = self.ai settings.ship limit 
self.score = 0 
self.level = 1 


为 让 Scoreboard 能 够 在 当前 得 分 下 方 显 示 当 前 等 级 我 们 在 _init _() 中 调用 了 一 个 新 方法 
prep_level(): 


scoreboard.py 


def init (self, ai settings, screen, stats): 
-- Snip-- 


# 准备 包含 得 分 的 初始 图 像 
self.prep_score() 
self.prep high score() 
self.prep level() 


prep_level() 的 代码 如 下 : 
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Scoreboard.py 


def prep level(self): 
@ self.level image = self.font.render(str(self.stats.level), True, 
self.text color, self.ai settings.bg color) 


# 将 等 级 放 在 得 分 下 方 

self.level rect = self.level image.get rect() 
self.level rect.right = self.score rect.right 
self.level rect.top = self.score rect.bottom + 10 


©O® 
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方法 prep_level() 根 据 存 储 在 stats .level 中 的 值 创建 一 幅 图 像 ( 见 @ )， 并 将 其 right 属 性 设 
置 为 得 分 的 right 属 性 ( 见 @ ), 然后 , 将 top 属 性 设置 为 比 得 分 图 像 的 bottom 属 性 大 10 像 素 ， 以 便 
在 得 分 和 等 级 之 间 留 出 一 定 的 空间 ( 见 @ )。 

我 们 还 需要 更 新 show_score() : 


Scoreboard.py 


def show score(self) 
""" 在 屏幕 上 显示 飞船 和 得 分 """ 
self.screen.blit(self.score image, self.score rect) 
self.screen.blit(self.high score image, self.high score rect) 
self.screen.blit(self.level image, self.level rect) 


在 这 个 方法 中 ,添加 了 一 行 在 屏幕 上 显示 等 级 图 像 的 代码 。 
我 们 在 check_bullet alien collisions() 中 提高 等 级 ， 并 更 新 等 级 图 像 : 


game functions.py 


def check bullet alien collisions(ai settings, screen, stats, sb, ship, 
aliens, bullets): 
-- Ship-- 
if len(aliens) == 0: 
# 如 果 整 群 外 星人 都 被 消灭 ， 就 提高 一 个 等 级 
bullets .empty() 
ai settings.increase speed() 


# 提高 等 级 
© stats.level += 1 
© sb.prep level() 


create fleet(ai settings, screen, ship, aliens) 


如 果 整 群 外 星人 都 被 消灭 ， 我们 就 将 stats .level 的 值 加 1 ( 见 @ )， 并 调用 prep_level()， 以 
确保 正确 地 显示 新 等 级 ( 见 @ )。 
为 确保 开始 新 游戏 时 更 新 记分 和 等 级 图 像 ， 在 按钮 Play 被 单 击 时 触发 重 置 : 


game _ functions.py 


def check play button(ai settings, screen, stats, sb, play button, ship, 


aliens, bullets, mouse x, mouse y): 
""" 在 玩家 单 击 Play 按 钮 时 开始 新 游戏 """ 
button clicked = play button.rect.collidepoint(mouse x, mouse y) 
if button clicked and not stats.game active: 

-- SNip-- 


# 重 置 游戏 统计 信息 
stats.reset stats() 
stats.game active = True 


# 重 置 记分 牌 图 像 

© sb.prep_score() 
sb.prep high score() 
sb.prep level() 


# 清空 外 星人 列表 和 子弹 列表 
aliens.empty() 
bullets.empty() 


-- Snip-- 


check_play_button() 的 定义 需要 包含 对 象 sb。 为 重 置 记分 牌 图 像 , 我 们 在 重 置 相关 游戏 设置 
后 调用 prep_score()、prep_high_score() 和 prep_level() ( 见 @ )。 
在 check_events() 中 ,现在 需要 向 check_play_button() 传 递 sb， 让 它 能 够 访问 记分 牌 对 象 : 


game_functions.py 


def check events(ai settings, screen, stats, sb, play button, ship, aliens, 
bullets): 
"" 响 应 按键 和 和 饼 标 事件 """ 
for event in pygame.event.get(): 

if event.type == pygame.QUIT: 
-- Snip-- 

elif event.type == pygame.MOUSEBUTTONDOWN: 
mouse x, mouse y = pygame.mouse.get pos() 

@ check play button(ai settings, screen, stats, sb, play_button, 
ship, aliens, bullets, mouse x, mouse y) 


check_events() 的 定义 需要 包含 形 参 sb， 这 样 调用 check_play_button() 时 ,才能 将 sb 作为 实 
参 传递 给 它 ( 见 @ )。 
最 后 ， 更 新 alien_invasion.py 中 调用 check_events() 的 代码 ， 也 向 它 传递 sb: 


alien_invasion.py 


# 开始 游戏 主 御 环 
while True: 
gf.check events(ai settings, screen, stats, sb, play button, ship, 
aliens, bullets) 
--Snip-- 


现在 你 可 以 知道 升 到 多 少 级 了 ， 如 图 14-5 所 示 。 


图 14-5 ”当前 等 级 显示 在 当前 得 分 的 正 下 方 


注意 在 一 些 经 典 游戏 中 ， 得 分 带 标签 ， 如 Score、High Score 和 Level。 我 们 没有 显示 这 些 标签 ， 
因为 开始 玩 这 款 游戏 后 ,每 个 数字 的 含义 将 一 目 了 然 。 要 包含 这 些 标签 ,只 需 在 Scoreboard 
中 调用 font .render() 前 ， 将 它们 添加 到 得 分 字符 串 中 即 可 。 


14.3.9 显示 余下 的 飞船 数 


最 后 , 我们 来 显示 玩家 还 有 多 少 艘 飞船， 但 使 用 图 形 而 不 是 数字 。 为 此 , 我 们 在 屏幕 左上 角 
绘制 飞船 图 像 来 指出 还 余下 多 少 稻 飞船 ， 就 像 众多 经 典 的 街机 游戏 那样 。 CC 
首先 ， 需要 让 Ship 继 承 Sprite， 以 便 能 够 创建 飞船 编组 : 


ship.py 


import pygame 
from pygame.sprite import Sprite 


@ class Ship(Sprite): 


def init (self, ai settings, screen): 
"" "初始化 飞船 ， 并 设置 其 起 始 位 置 """ 
© super(Ship, self). init () 
--SNip-- 


在 这 里 ,我 们 导入 了 Sprite, 让 Ship 继 承 Sprite ( 见 @ ), 并 在 _ init__() 的 开头 就 调用 了 super() 
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( 见 @ )。 
接 下 来 ,需要 修改 Scoreboard， 在 其 中 创建 一 个 可 供 显示 的 飞船 编组 。 下 面 是 其 中 的 import 
语句 和 方法 _init _(): 


scoreboard.py 


import pygame.font 
from pygame.sprite import Group 


from ship import Ship 


class Scoreboard(): 


Wn "报告 得 分 信 息 的 3 Wn 


def init (self, ai settings, screen, stats): 
-- Snip-- 
self.prep level() 
self.prep ships() 


-- Ship-- 


鉴于 要 创建 一 个 飞船 编组 ， 我 们 导入 Group 和 Ship 类 。 调 用 prep_level() 后 ， 我 们 调用 了 
prep_ships()。 
prep_ships() 的 代码 如 下 : 


scoreboard.py 


def prep ships(self): 

""" 显 示 还 余下 多 少 艘 飞船 """ 

self.ships = Group() 

for ship number in range(self.stats.ships left): 
ship = Ship(self.ai settings, self.screen) 
ship.rect.x = 10 + ship number * ship.rect.width 
ship.rect.y = 10 
self. ships.add(ship) 


方法 prep_ships() 创 建 一 个 空 编组 self.ships, 用 于 存储 飞船 实例 ( 见 @ )。 为 填充 这 个 编组 ， 
根据 玩家 还 有 和 多少 稻 飞船 运行 一 个 循环 相应 的 次 数 ( 见 @ )。 在 这 个 循环 中 ， 我 们 创建 一 稻 新 飞 
船 , 并 设置 其 x 坐标 , 让 整个 飞船 编组 都 位 于 屏幕 左边 , 且 每 艘 飞船 的 左边 距 都 为 10 像 素 ( 见 @ )。 
我 们 还 将 ?坐标 设置 为 离 屏幕 上 边缘 10 像 素 ， 让 所 有 飞船 都 与 得 分 图 像 对 齐 ( 见 @ )。 最后， 我 们 
将 每 笨 新 飞船 都 庄 加 到 编组 ships 中 ( 见 @ )。 

现在 需要 在 屏幕 上 绘制 飞船 了 : 


Scoreboard.py 


ee ©® 


def show score(self): 
-- Snip-- 
self.screen.blit(self.level image, self.level rect) 
# 绘制 飞船 
self.ships.draw(self.screen) 
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为 在 屏幕 上 显示 飞船 ， 我 们 对 编组 调用 了 draw()。Pygame 将 绘制 每 艘 飞船 。 
为 在 游戏 开始 时 让 玩家 知道 他 有 多 少 艘 飞船 ， 我 们 在 开始 新 游戏 时 调用 prep_ships()。 这 是 
在 game_functions.py 的 check_play_button() 中 进行 的 : 


game functions.py 


def check play button(ai settings, screen, stats, sb, play button, ship, 
iens, bullets, mouse x, mouse yy): 
"" 在 玩家 单 击 Play 按 钮 时 开始 新 游戏 "" 
button clicked = play button.rect.collidepoint(mouse x, mouse y) 
if button clicked and not stats.game active: 
0 
重 置 记 分 关 多 后 图 像 修 
和 人 
b.prep_high_score() 
b.prep level() 
sb.prep_ ships() 
-- SNip-- 


CU 
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我 们 还 在 飞船 被 外 星人 撞 到 时 调用 prep_ships()， 从 而 在 玩家 损失 一 艘 飞船 时 更 新 飞船 图 像 : 


game _ functions.py 


@ def update aliens(ai settings, screen, stats, sb, ship, aliens, bullets) 
-- Snip-- 
# 检测 外 星人 和 飞船 之 间 的 碰撞 
if pygame.sprite.spritecollideany(ship, aliens): 

[29 ship hit(ai settings, screen, stats, sb, ship, aliens, bullets) 


# 检查 是 否 有 外 星人 抵达 屏幕 底 病 
© check aliens bottom(ai settings, screen, stats, sb, ship, aliens, bullets) 


@ def shap hit(ai settings, screen, stats, sb, ship, aliens, bullets): 
"响应 被 外 星人 撞 到 的 飞船 """ 
if stats.ships left > 0: 
# 将 ships_left 减 1 
stats.ships left -= 1 


# 更 新 记分 牌 
© sb.prep ships() 


# 清空 外 星人 列表 和 子弹 列表 
-- snip-- 


首先 , 我 们 在 update_aliens() 的 定义 中 添加 了 形 参 sb ( 见 @ ), 然后 , 我们 向 ship_hit()( 见 
@ ) 和 check aliens bottom()( 见 @ ) 都 传递 了 sb， 让 它们 都 色 6 够 访问 记分 牌 对 象 。 

接 下 来 ， 我们 更 新 了 ship_hit() 的 定义 ,使 其 包含 形 参 sb( 见 @ )。 我 们 在 将 ships_left 的 值 
减 1 后 调用 了 prep_ships()( 见 @ )， 这 样 每 次 损失 了 飞船 时 ， 显 示 的 飞船 数 都 是 正确 的 。 

在 check aliens_bottom() 中 需要 调用 ship_hit()， 因 此 对 这 个 函数 进行 更 新 : 
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game_functions.py 


def check aliens bottom(ai settings, screen, stats, sb, ship, aliens, 
bullets): 
"" "检查 是 否 有 外 星人 抵达 屏幕 底 莫 """ 
screen rect = screen.get rect() 
for alien in aliens.sprites(): 
if alien.rect.bottom >= screen rect.bottom: 
# 像 飞船 被 外 星人 撞 到 一 样 处 理 
ship hit(ai settings, screen, stats, sb, ship, aliens, bullets) 
break 


现在 ，check aliens_bottom() 包 含 形 参 sb， 并 在 调用 ship_hit() 时 传递 了 实 参 sb。 
最 后 ， 在 alien_invasion.py 中 修改 调用 update aliens() 的 代码 ， 向 它 传递 实 参 sb: 


alien_invasion.py 


# 开始 游戏 主 循环 
while True : 
-- Snip-- 
if stats.game active: 
ship.update() 
gf.update bullets(ai settings, screen, stats, sb, ship, aliens, 
bullets) 
gf.update aliens(ai settings, screen, stats, sb, ship, aliens, 
bullets) 
-~- Snip-- 


图 14-6 显 示 了 完整 的 记分 系统 ， 它 在 屏幕 左上 角 指 出 了 还 余下 多 少 笨 飞船 。 
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会 
图 14-6 ”游戏 《外 星人 入 侵 》 的 完整 记分 系统 
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动手 试 一 斌 

14-4 历史 最 高 分 : 每 当 玩家 关闭 并 重新 开始 游戏 《外 星人 入 侵 》 时 ， 最 高 分 都 将 
被 重 置 。 请 修复 这 个 问题 ， 调 用 sys.exit() 前 将 最 高 分 写 入 文件 ， 并 当 在 GameStats 中 
初始 化 最 高 分 时 从 文件 中 读 取 它 。 

14-5 重 构 : 找 出 执行 了 多 项 任务 的 函数 和 方法 ， 对 它们 进行 重 构 ， 以 让 代码 高 效 
而 有 序 。 例如， 对 于 check bullet alien collisions(), 将 其 中 在 外 星人 群 被 消灭 干净 
时 开始 新 等 级 的 代码 移 到 一 个 名 为 start new level() 的 函数 中 ; 又 比如 ， 对 于 
Scoreboard 的 方法 _init ()， 将 其 中 调用 四 个 不 同方 法 的 代码 移 到 一 个 名 为 
prep_images() 的 方法 中 ， 以 缩短 方法 init ()。 如 果 你 重 构 了 check play_button()， 
方法 prep_ images() 也 可 为 check play button() 或 start game() 提 供 才 助 。 


注意 ” 重 构 项 目前 ， 请 阅读 附录 DD， 了 解 如 果 重 构 时 引入 了 bug， 如 何 将 项 目 恢复 到 可 
正确 运行 的 状态 。 


14-6 扩展 游戏 《外 星人 入 侵 》 想 想 如 何 扩展 游戏 《外 星人 入 侵 》 例如 ， 可 让 外 
星人 也 能 够 向 飞船 射击 ,或 者 添加 盾牌 ,让 飞船 艇 到 它 后 面 , 使 得 只 有 从 两 边 射 来 的 子 
弹 才能 摧毁 飞船 。 另 外 ， 还 可 以 使 用 像 pygame.mixer 这 样 的 模块 来 添加 音效 ， 如 爆炸 
声 和 射击 声 。 
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在 本 章 中 ， 你 学 习 了 如 何 创建 用 于 开始 新 游戏 的 Play 按钮 ， 如 何 检测 鼠标 事件 ， 以 及 在 游戏 
处 于 活动 状态 时 如 何 隐 藏 光标 。 你 可 以 利用 学 到 的 知识 在 游戏 中 创建 其 他 按钮 ,如 用 于 显示 玩法 4 
说 明 的 Help 按 钮 。 你 还 学 习 了 如 何 随 游 戏 的 进行 调整 其 节奏 ， 如 何 实现 记分 系统 ， 以 及 如 何以 文 
本 和 非 文本 方式 显示 信息 。 


项 目 2 数据 可 视 化 


生成 数据 


数据 可 视 化 指 的 是 通过 可 视 化 表示 来 探索 数据 , 它 与 数据 挖 气 紧 
密 相 关 ， 而 数据 挖 握 指 的 是 使 用 代码 来 探索 数据 集 的 规律 和 关联 。 数 
据 集 可 以 是 用 一 行 代码 就 能 表示 的 小 型 数字 列表 ,也 可 以 是 数 以 吉 字 
节 的 数据 。 

漂亮 地 呈现 数据 关乎 的 并 非 仅仅 是 漂亮 的 图 片 ,以 引 人 注 目的 简 
洁 方 式 哇 现 数据 ,让 观看 者 能 够 明白 其 含义 , 发 现 数据 集中 原本 未 意 
识 到 的 规律 和 意义 。 

所 幸 即 便 没 有 超级 计算 机 ， 也 能 够 可 视 化 复杂 的 数据 。 鉴 于 Python 
的 高 效 性 ， 使 用 它 在 笔记 本 电脑 上 就 能 快速 地 探索 由 数 百 万 个 数据 点 
组 成 的 数据 集 。 数 据点 并 非 必 须 是 数字 ， 利 用 本 书 前 半 部 分 介绍 的 基本 知识 ， 也 可 以 对 非 数 字 
数据 进行 分 析 。 

在 基因 研究 、 天 气 研 究 、 政 治 经 济 分 析 等 众多 领域 ， 大 家 都 使 用 Python 来 完成 数据 密集 型 
工作 。 数据 科学 家 使 用 Python 编 写 了 一 系列 令 人 印象 深刻 的 可 视 化 和 分 析 工 具 , 其 中 很 多 也 可 
供 你 使 用 。 最 流行 的 工具 之 一 是 matplotlib， 它 是 一 个 数学 绘图 库 ， 我 们 将 使 用 它 来 制作 简单 
的 图 表 ， 如 折线 图 和 散 点 图 。 然 后 ， 我 们 将 基于 随机 漫步 概念 生成 一 个 更 有 趣 的 数据 集 一 一 
根据 一 系列 随机 决策 生成 的 图 表 。 

我 们 还 将 使 用 Pygal 包 ， 它 专注 于 生成 适合 在 数字 设备 上 显示 的 图 表 。 通 过 使 用 Pygal， 
可 在 用 户 与 图 表 交 互 时 突出 元 素 以 及 调整 其 大 小 , 还 可 轻松 地 调整 整个 图 表 的 尺寸 , 使 其 适 
合 在 微型 智能 手表 或 巨型 显示 器 上 显示 。 我 们 将 使 用 Pygal 以 各 种 方式 探索 拨 暴 子 的 结果 。 


15.1 安装 matplotlib 


首先 ， 需要 安装 matplotlib， 我 们 将 使 用 它 来 制作 开始 的 几 个 图 表 。 如 果 你 还 未 使 用 过 pip， 
请 参阅 12.2.1 节 。 
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15.1.1 在 Linux 系统 中 安装 matplotlib 
如 果 你 使 用 的 是 系统 自 带 的 Python 版 本 ,可 使 用 系统 的 包 管理 器 来 安装 matplotlib ， 为 此 只 需 
执行 一 行 命令 ， 


$ sudo apt-get install python3-matplotlib 


如 果 你 使 用 的 是 Python 2.7， 请 执行 如 下 命令 : 


$ sudo apt-get install python-matplotlib 


如 果 你 安装 了 较 新 的 Python 版 本 ， 就 必须 安装 matplotlib 依 赖 的 一 些 库 : 


sudo apt-get install python3.5-dev python3.5-tk tk-dev 
sudo apt-get install libfreetype6-dev g++ 


再 使 用 pip 来 安装 matplotlib : 


pip install --user matplotlib 


15.1.2 ”在 OSX 系统 中 安装 matplotlib 

Apple 的 标准 Python 安 装 自 带 了 matplotlib。 要 检查 系统 是 否 安装 了 matplotlib， 可 打开 一 个 终 
端 会 话 并 尝试 导 和 人 matplotlib。 如 果 系 统 没 有 自 带 matplotlib ， 且 你 的 Python 是 使 用 Homebrew 安 装 
的 ， 则 可 以 像 下 面 这 样 安装 matplotlib : 


$ pip install --user matplotlib 


注意 安装 包 时 可 能 需要 使 用 pip3， 而 不 是 pip。 另 外 ， 如 果 这 个 命令 不 管用 ， 你 可 能 需要 删除 


4/ 
标志 --USseT。 


15.1.3 ”在 Windows 系统 中 安装 matplotlib 


在 Windows 系 统 中 ， 首 先 需 要 安装 Visual Studio。 为 此 ， 请 访问 https:/dev.windows.com/， 单 
击 Downloads ， 再 查找 Visual Studio Community 一 组 免费 的 Windows 开 发 工具 。 请 下 载 并 运行 
该 安装 程序 。 

接 下 来 ， 需 要 下 载 matplotlib 安 装 程序 。 为 此 ， 请 访问 https:/pypi.python.org/pypi/matplotlib/， 
并 查找 与 你 使 用 的 Python 版 本 匹配 的 wheel 文 件 (扩展 名 为 .whl 的 文件 )。 例 如 ， 如 果 你 使 用 的 是 
32 位 的 Python 3.5， 则 需要 下 载 matplotlib-1.4.3-cp35-none-win32.whl。 
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注意 如 果 找 不 到 与 你 安装 的 Python 版 本 匹配 的 文件 ， 请 去 http:/www.lfd.uci.edu/-gohlke/ 
pythonlibs/#matplotlib 看 看 ， 这 个 网 站 发 布 安装 程序 的 时 间 通 常 比 matplotlib 官 网 早 些 。 


将 这 个 .whl 文 件 复制 到 你 的 项 目 文 件 夹 ， 打 开 一 个 命令 窗口 ， 并 切换 到 该 项 目 文 件 夹 ， 青 使 
用 pip 来 安装 matplotlib: 


> cd python_work 
python work> python -m pip install --user matplotlib-1.4.3-cp35-none-win32.whl 


15.1.4 测试 matplotlib 


安装 必要 的 包 后 ， 对 安装 进行 测试 。 为 此 ， 首 先 使 用 命令 python 或 python3 启 动 一 个 终端 会 
话 ， 再 尝试 导 人 matplotlib : 


$ python3 
>>> import matplotlib 
>>> 


如 果 没 有 出 现任 何 错 误 消息 ， 就 说 明 你 的 系统 安装 了 matplotlib， 可 以 接着 阅读 下 一 节 。 
注意 ”如果 你 在 安装 过 程 中 遇 到 了 麻烦 ,请 参阅 附录 C。 如 果 依然 无 济 于 事 , 请 向 他 人 寻求 帮助 。 


对 于 你 遇 到 的 问题 ， 只 要 向 经 验 丰富 的 Python 程序 员 提 供 少 量 的 信息 ， 他 们 很 可 能 很 快 
就 能 帮 你 解决 。 


15.1.5 ”matplotlib 画廊 


要 查看 使 用 matplotlib 可 制作 的 各 种 图 表 ， 请 访问 http://matplotlib.org/ 的 示例 画廊 。 单 击 画 廊 
中 的 图 表 ， 就 可 查看 用 于 生成 图 表 的 代码 。 


15.2 ”绘制 简单 的 折线 图 


下 面 来 使 用 matplotlib 绘 制 一 个 简单 的 折线 图 , 再 对 其 进行 定制 , 以 实现 信息 更 丰富 的 数据 可 
视 化 。 我 们 将 使 用 平方 数 序列 1、4、9、16 和 25 来 绘制 这 个 图 表 。 
只 需 向 matplotlib 提 供 如 下 数字 ，matplotlib 就 能 完成 其 他 的 工作 : 


mpl_squares.py 


import matplotlib.pyplot as plt 


squares = [1, 4, 9, 16, 25] 
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plt.plot(squares) 
plt. show() 


我 们 首先 导入 了 模块 pyplot, 并 给 它 指定 了 别名 plt, 以 免 反 复 输 入 pyplot。 在 线 示 例 大 都 这 
样 做 ， 因 此 这 里 也 这 样 做 。 模 块 pyplot 包 含 很 多 用 于 生成 图 表 的 函数 。 
我 们 创建 了 一 个 列表 ,在 其 中 存储 了 前 述 平方 数 ， 再 将 这 个 列表 传递 给 函数 plot()， 这 个 函 
尝试 根据 这 些 数字 绘制 出 有 意义 的 图 形 。plt.show() 打 开 matplotlib 查 看 器 , 并 显示 绘制 的 图 形 ， 
如 图 15-1 所 示 。 查 看 器 让 你 能 够 缩放 和 导航 图 形 ， 另 外 ， 单 击 磁盘 图 标 可 将 图 形 保存 起 来 。 


图 15-1 使 用 matplotlib 可 制作 的 最 简单 的 图 表 


15.2.1 修改 标签 文字 和 线条 粗细 

图 15-1 所 示 的 图 形 表明 数字 是 越 来 越 大 的 ,但 标签 文字 太 小 ,线条 太 细 。 所 幸 matplotlib 让 你 
能 够 调整 可 视 化 的 各 个 方面 。 

下 面 通过 一 些 定制 来 改善 这 个 图 形 的 可 读 性 ， 如 下 所 示 : 


mpl_squares.py 


import matplotlib.pyplot as plt 


squares = [1, 4, 9,，16, 25] 
@ plt.plot(squares, linewidth=5) 


# 设置 图 表 标 题 ， 并 给 坐标 轴 加 上 标签 
@ plt.title("Square Numbers", fontsize=24) 
@ plt.xlabel("Value", fontsize=14) 
plt.ylabel("Square of Value", fontsize=14) 


# 设置 刻度 标记 的 大 小 
@ plt.tick params(axis='both', labelsize=14) 
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plt. show() 


参数 linewidth ( 见 @ ) 决定 了 plot() 绘 制 的 线条 的 粗细 。 隐 数 title() ( 见 @ ) 给 图 表 指 定 标 
题 。 在 上 述 代 码 中 ， 出 现 了 多 次 的 参数 fontsize 指 定 了 图 表 中 文字 的 大 小 。 

函数 xlabel() 和 ylabel() 让 你 能 够 为 每 条 轴 设 置 标题 ( 见 @ ); 而 函数 tick_params() 设 置 刻 度 
的 样式 ( 见 @ )， 其 中 指定 的 实 参 将 影响 x 轴 和 y 轴 上 的 刻度 ( axes='both' ), 并 将 刻度 标记 的 字号 
设置 为 14 ( labelsize=14 )。 

最 终 的 图 表 阅 读 起 来 容易 得 多 了 ， 如 图 15-2 所 示 : 标签 文字 更 大 ， 线 条 也 更 粗 。 


图 15-2 ”现在 图 表 阅 读 起 来 容易 得 多 


15.2.2 ”校正 图 形 

图 形 更 容易 阅读 后 ， 我 们 发 现 没有 正确 地 绘制 数据 : 折线 图 的 终点 指出 4.0 的 平方 为 251 下 
面 来 修复 这 个 问题 。 

当 你 向 plot() 提 供 一 系列 数字 时 ， 它 假设 第 一 个 数据 点 对 应 的 x 坐标 值 为 0， 但 我 们 的 第 一 个 5 
点 对 应 的 x 值 为 1。 为 改变 这 种 默认 行为 ， 我 们 可 以 给 plot() 同 时 提供 输入 值 和 输出 值 : 


mpl_ squares.py 


import matplotlib.pyplot as plt 


input_values = [1, 2, 3, 4, 5] 
squares = [1, 4, 9, 16, 25] 
plt.plot(input values, squares, linewidth=5) 


# 设置 图 表 标 题 并 给 坐标 轴 加 上 标签 
-- Snip-- 
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现在 plot() 将 正确 地 绘制 数据 ， 因 为 我 们 同时 提供 了 输入 值 和 输出 值 ， 它 无 需 对 输出 值 的 生 
成 方式 作出 假设 。 最 终 的 图 形 是 正确 的 ， 如 图 15-3 所 示 。 


Square Numbers 


23 


Square of Value 


?5 5 0 2.5 3.0 35 4.0 4.5 5:0 
Value 


从 QO|+ 喇 各国 


SN 


图 15-3 ”根据 数据 正确 地 绘制 了 图 


使 用 plot() 时 可 指定 各 种 实 参 ,还 可 使 用 众多 函数 对 图 形 进行 定制 。 本 章 后 面 处 理 更 有 趣 的 
数据 集 时 ， 将 继续 探索 这 些 定制 函数 。 


15.2.3 ”使 用 scatter() 绘 制 散 点 图 并 设置 其 样式 


有 时 候 , 需要 绘制 散 点 图 并 设置 各 个 数据 点 的 样式 。 例 如 ,你 可 能 想 以 一 种 颜色 显示 较 小 的 
值 ， 而 用 另 一 种 颜色 显示 较 大 的 值 。 绘 制 大 型 数据 集 时 ， 你 还 可 以 对 每 个 点 都 设置 同样 的 样式 ， 
再 使 用 不 同 的 样式 选项 重新 绘制 某 些 点 ， 以 突出 它们 。 

要 绘制 单个 点 ， 可 使 用 函数 scatter() ， 并 向 它 传递 一 对 x* 和 ) 坐 标 ， 它 将 在 指定 位 置 绘制 一 
个 点 : 


scatter_squares.py 


import matplotlib.pyplot as plt 


plt.scatter(2, 4) 
plt.show() 


下 面 来 设置 输出 的 样式 , 使 其 更 有 趣 ; 添加 标题 ,给 轴 加 上 标签 ,并 确保 所 有 文本 都 大 到 能 
够 看 清 : 


import matplotlib.pyplot as plt 


@ plt.scatter(2, 4, s=200) 
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# 设置 图 表 标 题 并 给 坐标 轴 加 上 标签 
plt.title("Square Numbers", fontsize=24) 
plt.xlabel("Value", fontsize=14) 
plt.ylabel("Square of Value", fontsize=14) 


G23 


设置 刻度 标记 的 大 小 
plt.tick params(axis="both', which="'major', labelsize=14) 


plt.show() 


在 @ 人 处， 我 们 调用 了 scatter()， 并 使 用 实 参 s 设 置 了 绘制 图 形 时 使 用 的 点 的 尺寸 。 如 果 此 时 
运行 scatter_squares.py， 将 在 图 表 中 央 看 到 一 个 点 ， 如 图 15-4 所 示 。 


图 15-4 ”绘制 单个 点 


15.2.4 使 用 scatter() 绘 制 一 系列 点 
要 绘制 一 系列 的 点 ， 可 向 scatter() 传 递 两 个 分 别 包含 x* 值 和 y 值 的 列表 ， 如 下 所 示 : 


scatter_squares.py 


import matplotlib.pyplot as plt 


x_values 
y_values 


[1, 2, 3, 4, 5] 
[1, 4, 9,16, 25] 


plt.scatter(x_values, y_values, s=100) 


# 设置 图 表 标 题 并 给 坐标 轴 指 定 标 签 
-- Snip-- 
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列表 x_values 包 含 要 计算 其 平方 值 的 数字 ， 而 列表 y_values 包 含 前 述 每 个 数字 的 平方 值 。 将 
这 些 列表 传递 给 scatter() 时 ，matplotlib 依 次 从 每 个 列表 中 读 取 一 个 值 来 绘制 一 个 点 。 要 绘制 的 
点 的 坐标 分 别 为 (1, 1)、(2, 4)、(3, 9)、(4, 16) 和 (5, 25)， 最 终 的 结果 如 图 15-5 所 示 。 


图 15-5 ”由 多 个 点 组 成 的 散 点 图 


15.2.5 ”自动 计算 数据 


手工 计算 列表 要 包含 的 值 可 能 效率 低下 , 需要 绘制 的 点 很 多 时 尤其 如 此 。 可 以 不 必 手 工 计算 
包含 点 坐标 的 列表 ， 而 让 Python 循环 来 蔡 我 们 完成 这 种 计算 。 下 面 是 绘制 1000 个 点 的 代码 : 


scatter_squares.py 


import matplotlib.pyplot as plt 


@ x values = list(range(1, 1001)) 
y_values = [x**2 for x in x_values] 


@ plt.scatter(x values, y values, s=40) 


# 设置 图 表 标题 并 给 坐标 轴 加 上 标签 
-- Snip-- 


# 设置 每 个 坐标 轴 的 取 值 范围 
@ plt.axis([0，1100，0，1100000]) 


plt.show() 


我 们 首先 创建 了 一 个 包含 x 值 的 列表 ， 其 中 包含 数字 1~1000 ( 见 @ )。 接 下 来 是 一 个 生成 ) 值 
的 列表 解析 , 它 遍 历 x 值 ( for x in x_values ), 计算 其 平方 值 ( x**2 ), 并 将 结果 存储 到 列表 y_values 
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中 。 然 后 ， 将 输入 列表 和 输出 列表 传递 给 scatter() ( 见 @ )。 

由 于 这 个 数据 集 较 大 ,我 们 将 点 设置 得 较 小 ,并 使 用 函数 axis() 指 定 了 每 个 坐标 轴 的 取 值 范 
围 〈 见 目 )。 函 数 axis() 要 求 提供 四 个 值 : x 和 y 坐 标 轴 的 最 小 值 和 最 大 值 。 在 这 里 ， 我 们 将 x 坐标 
轴 的 取 值 范围 设置 为 0~1100， 并 将 ?坐标 轴 的 取 值 范围 设置 为 0~1 100 000。 结 果 如 图 15-6 所 示 。 


Square Numbers 
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200000 
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图 15-6 ”Python 绘制 1000 个 点 与 绘制 5 个 点 一 样 容易 


15.2.6 ”删除 数据 点 的 轮廓 


matplotlib 人 允许 你 给 散 点 图 中 的 各 个 点 指定 颜色 。 默认 为 蓝 色 点 和 黑色 轮廓 , 在 散 点 图 包含 的 
数据 点 不 多 时 效果 很 好 。 但 绘制 很 多 点 时 ， 黑 色 轮 廓 可 能 会 粘连 在 一 起 。 要 删除 数据 点 的 轮廓 ， 
可 在 调用 scatter() 时 传递 实 参 edgecolor='none ' : 


plt.scatter(x values, y values, edgecolor='none', s=40) 


将 相应 调用 修改 为 上 述 代 码 后 ， 如 果 再 运行 scatter_ squares.py， 在 图 表 中 看 到 的 将 是 蓝 色 实 15 
心 点 


wo 


15.2.7 ” 自 定 义 闫 色 


要 修改 数据 点 的 颜色 ， 可 向 scatter() 传 递 参 数 c， 并 将 其 设置 为 要 使 用 的 颜色 的 名 称 ， 如 下 
所 示 : 


plt.scatter(x values, y_ values, c='red', edgecolor="'none', s=40) 


你 还 可 以 使 用 RGB 颜色 模式 自 定 义 颜色 。 要 指定 自 定义 颜色 ， 可 传递 参数 c， 并 将 其 设置 为 


J 
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一 个 元 组 ， 其 中 包含 三 个 0~1 之 间 的 小 数值 ， 它 们 分 别 表示 红色 、 绿 色 和 蓝 色 分 量 。 例 如 ， 下 面 
的 代码 行 创建 一 个 由 淡 蓝 色 点 组 成 的 散 点 图 : 


plt.scatter(x values, y values, c=(0, 0, 0.8), edgecolor='none' , s=40) 


值 越 接近 0， 指 定 的 颜色 越 深 ， 值 越 接近 1， 指 定 的 颜色 越 浅 。 


15.2.8 ”使 用 颜色 映射 


颜色 映射 ( colormap ) 是 一 系列 颜色 ,它们 从 起 始 颜 色 渐 变 到 结束 颜色 。 在 可 视 化 中 ,颜色 
映射 用 于 突出 数据 的 规律 , 例如 ,你 可 能 用 较 浅 的 颜色 来 显示 较 小 的 值 ， 并 使 用 较 深 的 颜色 来 显 
示 较 大 的 值 。 

模块 pyplot 内 置 了 一 组 颜色 映射 。 要 使 用 这 些 颜色 映射 ， 你 需要 告诉 pyplot 该 如 何 设置 数据 
集中 每 个 点 的 颜色 。 下 面 演示 了 如 何 根据 每 个 点 的 ? 值 来 设置 其 颜色 : 


scatter_squares.py 


import matplotlib.pyplot as plt 


x values = list(range(1001)) 
y values = [x**2 for x in x values] 


plt.scatter(x values, y values, c=y values, cmap=plt.cm.Blues, 
edgecolor='"none' ,s=40) 


# 设置 图 表 标 题 并 给 坐标 轴 加 上 标签 
-- Snip-- 


我 们 将 参数 c 设 置 成 了 一 个 y 值 列表 ， 并 使 用 参数 cmap 告 诉 pyplot 使 用 哪个 颜色 映射 。 这 些 代 
码 将 y 值 较 小 的 点 显示 为 浅 蓝 色 ， 并 将 y 值 较 大 的 点 显示 为 深蓝 色 ， 生 成 的 图 形 如 图 15-7 所 示 。 


注意 ”要 了 解 pyplot 中 所 有 的 颜色 映射 ， 请 访问 http://matplotlib.org/， 单 击 Examples， 人 向 下 滚动 
到 Color Examples， 再 单 击 colormaps reference。 
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Square Numbers 
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800000 


600000 


400000 


Square of Value 


200000 


和 200 400 600 800 1000 
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从 @j©| 十 后 右 国 


图 15-7 使 用 颜色 映射 Blues 的 图 表 


15.2.9 自动 保存 图 表 


要 让 程序 自动 将 图 表 保 存 到 文件 中 ， 可 将 对 plt.show() 的 调用 替换 为 对 plt.savefig() 的 
调用 : 


plt.savefig('squares plot.png', bbox inches="'tight') 


第 一 个 实 参 指定 要 以 什么 样 的 文件 名 保存 图 表 ， 这 个 文件 将 存储 到 scatter_squares.py 所 在 的 
目录 中 ; 第 二 个 实 参 指定 将 图 表 多 余 的 空白 区 域 裁剪 掉 。 如 果 要 保留 图 表 周 围 多余 的 空白 区 域 ， 
可 省 略 这 个 实 参 。 


动手 试 一 斌 


15-1 立方 : 数字 的 三 次 方 被 称 为 其 立方 。 请 绘制 一 个 图 形 ,， 显示 前 5 个 整数 的 立方 


值 ， 再 绘制 一 个 图 形 ， 显 示 前 5000 个 整数 的 立方 值 。 
15-2 彩色 立方 : 给 你 前 面 绘制 的 立方 图 指定 颜色 映射 。 


15.3 ”随机 漫步 


在 本 节 中 , 我 们 将 使 用 Python 来 生成 随机 漫步 数据 ,再 使 用 matplotlib 以 引 人 瞩 目的 方式 将 这 
些 数 据 呈 现 出 来 。 随 机 漫步 是 这 样 行走 得 到 的 路 径 : 每 次 行走 都 完全 是 随机 的 , 没有 明确 的 方向 ， 
结果 是 由 一 系列 随机 决策 决定 的 。 你 可 以 这 样 认为 ， 随 机 漫步 就 是 蚂 蚊 在 晕 头 转向 的 情况 下 ， 
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次 都 沿 随机 的 方向 前 行 所 经 过 的 路 径 。 

在 自然 界 、 物 理学 、 生 物 学 、 化 学 和 经 济 领域 ,随机 漫步 都 有 其 实际 用 途 。 例 如 ,漂浮 在 水 
滴 上 的 花粉 因 不 断 受 到 水 分 子 的 挤 压 而 在 水 面 上 移动 。 水 滴 中 的 分 子 运动 是 随机 的 ，, 因此 花粉 在 
水 面 上 的 运动 路 径 犹 如 随机 漫步 。 我 们 稍 后 将 编写 的 代码 模拟 了 现实 世界 的 很 多 情形 。 


15.3.1 创建 RandomWalk() 类 


为 模拟 随机 漫步 ， 我 们 将 创建 一 个 名 为 RandomWalk 的 类 ， 它 随机 地 选择 前 进 方向 。 这 个 类 需 
要 三 个 属性 , 其 中 一 个 是 存储 随机 漫步 次 数 的 变量 ,其 他 两 个 是 列表 , 分 别 存储 随机 漫步 经 过 的 
每 个 点 的 x 和 y 坐 标 。 

RandomWalk 类 只 包含 两 个 方法 : ”init _() 和 fill walk(), 其 中 后 者 计算 随机 漫步 经 过 的 所 
有 点 。 下 面 先 来 看 看 _init ()， 如 下 所 示 : 


random_walk.py 


@ from random import choice 


class RandomWalk(): 
"" "一 个 生成 随机 漫步 数据 的 类 """ 


@ def init (self, num points=5000): 
""" 初 始 化 随机 漫步 的 属性 """ 
self.num points = num points 


# 所 有 随机 漫步 都 始 于 (0，0) 
(3 self.x values = [0] 
self.y values = [0] 


为 做 出 随机 决策 ， 我 们 将 所 有 可 能 的 选择 都 存储 在 一 个 列表 中 ， 并 在 每 次 做 决策 时 都 使 用 
choice() 来 决定 使 用 哪 种 选择 ( 见 @ )。 接 下 来 ,我 们 将 随机 漫步 包含 的 默认 点 数 设置 为 5000， 这 
大 到 足以 生成 有 趣 的 模式 ， 同 时 又 足够 小 ， 可 确保 能 够 快速 地 模拟 随机 漫步 ( 见 @ )。 然后 ,在 
@ 处 ,我们 创建 了 两 个 用 于 存储 x 和 y 值 的 列表 ， 并 让 每 次 漫步 都 从 点 (0, 0) 出 发 。 


15.3.2 ”选择 方向 


我 们 将 使 用 fill_walk() 来 生成 漫步 包含 的 点 ， 并 决定 每 次 漫步 的 方向 ， 如 下 所 示 。 请 将 这 
个 方法 添加 到 random_walk.py 中 : 


random_walk.py 


def fill walk(self) : 
"" 评 算 随 机 漫步 包含 的 所 有 点 "" 


# 不 断 漫步 ， 直 到 列表 达到 指定 的 长 度 
© while len(self.x values) < self.num points: 


15.3 ”随机 漫步 297 


# 决定 前 进 方向 以 及 沿 这 个 方向 前 进 的 距离 


© x direction = choice([1, -1]) 
x distance = choice([0, 1, 2, 3, 4]) 
3 X step = x direction * x distance 


y_direction = choice([1, -1]) 
y_distance = choice([0, 1, 2, 3, 4]) 


4 y_step = y direction * y distance 
# 拒绝 原 地 踏步 
© if x step == 0 and y step == 0: 
continue 


# 计算 下 一 个 点 的 x 和 y 值 
© next x = self.x values[-1] + x_step 
next y = self.y values[-1] + y_step 


self.x values.append(next x) 
self.y values.append(next y) 


在 @ 处 ， 我 们 建立 了 一 个 循环 ， 这 个 循环 不 断 运行 ， 直 到 漫步 包含 所 需 数量 的 点 。 这 个 方法 
的 主要 部 分 告诉 Python 如 何 模拟 四 种 漫步 决定 : 向 右 走 还 是 回 左 走 ? 党 指定 的 方向 走 多 远 ? 向 上 
走 还 是 向 下 走 ? 沿 选 定 的 方向 走 多 远 ? 

我 们 使 用 choice([1，-1]) 给 x_direction 选 择 一 个 值 ， 结 果 要 么 是 表示 向 右 走 的 1， 要 么 是 表 
示 向 左 走 的 -1 ( 见 @ )。 接 下 来 ，choice([0，1，2，3，4]) 随 机 地 选择 一 个 0~4 之 间 的 整数 ， 告 诉 
Python 沿 指定 的 方向 走 多 远 (x_distance )。( 通 过 包含 0， 我 们 不 仅 能 够 沿 两 个 轴 移 动 ， 还 能 够 
沿 y 轴 移动 。) 

在 @ 和 @ 处 , 我 们 将 移动 方向 乘 以 移动 距离 ， 以 确定 沿 x 和 y 轴 移动 的 距离 。 如 果 x_step 为 正 ， 
将 向 右 移 动 ， 为 负 将 向 左 移动 ， 而 为 零 将 垂直 移动 ; 如 果 y_step 为 正 ， 就 意味 着 向 上 移动 ， 为 负 
意味 着 向 下 移动 ， 而 为 零 意味 着 水 平移 动 。 如 果 x_step 和 y step 都 为 零 ， 则 意味 着 原 地 踏步 ， 我 
们 拒绝 这 样 的 情况 ， 接 着 执行 下 一 次 循环 ( 见 @ )。 

为 获取 漫步 中 下 一 个 点 的 x 值 ， 我 们 将 x_step 与 x_values 中 的 最 后 一 个 值 相 加 ( 见 @ ), 对 于 y 
值 也 做 相同 的 处 理 。 获 得 下 一 个 点 的 x 值 和 y 值 后 ,我 们 将 它们 分 别 附 加 到 列表 x_values 和 y_values 
的 末尾 。 


15.3.3 ”绘制 随机 漫步 
下 面 的 代码 将 随机 漫步 的 所 有 点 都 绘制 出 来 : 


rw_Vvisual.py 


import matplotlib.pyplot as plt 


from random walk import RandomWalk 
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# 创建 一 个 RandomWalk 实 例 ， 并 将 其 包含 的 点 都 绘制 出 来 
@ rw = RandomWalk() 
rw.fill walk() 
@ plt.scatter(rw.x values, rw.y values, s=15) 
plt.show() 


我 们 首先 导入 了 模块 pyplot 和 RandomWalk 类 ， 然 后 创建 了 一 个 RandomWalk 实 例 ， 并 将 其 存储 
到 rw 中 ( 见 @ )， 再 调用 fill walk()。 在 @ 处 ,我 们 将 随机 漫步 包含 的 x 和 y 值 传递 给 scatter()， 
并 选择 了 合适 的 点 尺寸 。 图 15-8 显 示 了 包含 5000 个 点 的 随机 漫步 图 (本 节 的 示意 图 未 包含 
matplotlib 查 看 器 部 分 ， 但 你 运行 rw_visual.py 时 ， 依 然 会 看 到 )。 


—100 


一 150 


-200 


-250 


一 300 
一 100 0 100 200 300 400 500 


图 15-8 ”包含 5000 个 点 的 随机 漫步 


15.3.4 ”模拟 多 次 随机 漫步 


每 次 随机 漫步 都 不 同 , 因此 探索 可 能 生成 的 各 种 模式 很 有 趣 。 要 在 不 多 次 运行 程序 的 情况 下 
使 用 前 面 的 代码 模拟 多 次 随机 漫步 ， 一 种 办 法 是 将 这 些 代 码 放 在 一 个 while 循 环 中 ， 如 下 所 示 : 


rw_visual.py 


import matplotlib.pyplot as plt 
from random walk import RandomWalk 


# 只 要 程序 处 于 活动 状态 ,就 不 断 地 模拟 随机 漫步 
while True: 
# 创建 一 个 RandomWalk 实 例 ， 并 将 其 包含 的 点 都 绘制 出 来 


rw = RandomWalk() 
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rw.fill walk() 
plt.scatter(rw.x values, rw.y values, s=15) 


plt. show() 
@ keep_ Tunning = input("Make another walk? (y/n): ") 
if keep running == 'N': 
break 


这 些 代码 模拟 一 次 随机 漫步 , 在 matplotlib 查 看 器 中 显示 结果 , 再 在 不 关闭 查看 器 的 情况 下 暂 
停 。 如 果 你 关闭 查看 需 ， 程 序 将 询问 你 是 否 要 再 模拟 一 次 随机 漫步 。 如 果 你 输入 y， 可 模拟 多 次 
随机 漫步 : 这 些 随 机 漫步 都 在 起 点 附近 进行 ， 大 多 治 特定 方向 偏离 起 点 ， 漫 步 点 分 布 不 均匀 等 。 
要 结束 程序 ， 请 输入 n。 


注意 ”如果 你 使 用 的 是 Python 2.7， 别 忘 了 将 @ 处 的 input() 替 换 为 Taw_input()。 


15.3.5 ”设置 随机 漫步 图 的 样式 


在 本 节 中 , 我 们 将 定制 图 表 ， 以 突出 每 次 漫步 的 重要 特征 ， 并 让 分 散 注意 力 的 元 素 不 那么 显 
眼 。 为 此 , 我们 确定 要 突出 的 元 素 ， 如 漫步 的 起 点 、 终 点 和 经 过 的 路 径 。 接 下 来 确定 要 使 其 不 那 
么 显眼 的 元 素 ， 如 刻度 标记 和 标签 。 最 终 的 结果 是 简单 的 可 视 化 表示 ,清楚 地 指出 了 每 次 漫步 经 
过 的 路 径 。 


15.3.6 ”给 点 着 色 


我 们 将 使 用 颜色 映射 来 指出 漫步 中 各 点 的 先后 顺序 , 并 删除 每 个 点 的 黑色 轮廓 ,让 它们 的 颜 
色 更 明显 。 为 根据 漫步 中 各 点 的 先后 顺序 进行 着 色 ， 我 们 传递 参数 c， 并 将 其 设置 为 一 个 列表 ， 
其 中 包含 各 点 的 先后 顺序 。 由 于 这 些 点 是 按 顺 序 绘制 的 ， 因 此 给 参数 c 指 定 的 列表 只 需 包 含 数字 
1~5000， 如 下 所 示 : 


rw_Vvisual.py 


-- Ship-- 

while True: 
# 创建 一 个 RandomWalk 实 例 ， 并 将 其 包含 的 点 都 绘制 出 来 
rw = RandomWalk() 
rw.fill walk() 


@ point numbers = list(range(rw.num points)) 
plt.scatter(rw.x values, rw.y values, c=point numbers, cmap=plt.cm.Blues, 
edgecolor="'none' ,s=15) 
plt. show() 


keep running = input("Make another walk? (y/n): ") 
-- Snip-- 
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在 @ 处 , 我 们 使 用 了 range() 生 成 了 一 个 数字 列表 , 其 中 包含 的 数字 个 数 与 漫步 包含 的 点 数 相 
同 。 接 下 来 ， 我 们 将 这 个 列表 存储 在 point_numbers 中 ， 以 便 后 面 使 用 它 来 设置 每 个 漫步 点 的 颜 
色 。 我 们 将 参数 c 设 置 为 point_ numbers， 指 定 使 用 颜色 映射 Blues， 并 传递 实 参 edgecolor=none 以 
删除 每 个 点 周围 的 轮廓 。 最 终 的 随机 漫步 图 从 浅 蓝 色 渐变 为 深蓝 色 ， 如 图 15-9 所 示 。 
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15.3.7 


图 15-9 ”使 用 颜色 映射 Blues 着 色 的 随机 漫步 图 


重新 绘制 起 点 和 终点 


除了 给 随机 漫步 的 各 个 点 着 色 , 以 指出 它们 的 先后 顺序 外 , 如 果 还 能 呈现 随机 漫步 的 起 点 和 
终点 就 更 好 了 。 为 此 , 可 在 绘制 随机 漫步 图 后 重新 绘制 起 点 和 终点 。 我 们 让 起 点 和 终点 变 得 更 大 ， 
并 显示 为 不 同 的 颜色 ， 以 突出 它们 ， 如 下 所 示 : 


rw_V 


isual.py 


--5170D-- 


while 


p 


壮 


芭 


TUes 

- SNIip-- 

t.scatter(rw.x values, rw.y values, c=point numbers, cmap=plt.cm.Blues, 
edgecolor="'none' ,s=15) 


突出 起 点 和 终点 

t.scatter(0, 0, c='green', edgecolors='none', s=100) 

It.scatter(rw.x values[-1], rw.y values[-1], c='red', edgecolors='none', 
s=100) 

t.show() 
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-- Ship-- 


为 突出 起 点 , 我 们 使 用 绿色 绘制 点 (0, 0)， 并 使 其 比 其 他 点 大 ( s= 


100 )。 为 突出 终点 ,我 们 在 


漫步 包含 的 最 后 一 个 x 和 y 值 处 绘制 一 个 点 ， 将 其 颜色 设置 为 红色 ， 并 将 尺寸 设置 为 100。 请 务必 
将 这 些 代 码 放 在 调用 plt.show() 的 代码 前 面 ， 确 保 在 其 他 点 的 上 面 绘 制 起 点 和 终点 。 
如 果 你 现在 运行 这 些 代码 , 将 能 准确 地 知道 每 次 随机 漫步 的 起 点 和 终点 ( 如 果 起 点 和 终点 不 


明显 ,请 调整 它们 的 颜色 和 大 小 ， 直 到 明显 为 止 )。 
15.3.8 ”隐藏 坐标 轴 


下 面 来 隐藏 这 个 图 表 中 的 坐标 轴 , 以 免 我 们 注意 的 是 坐标 轴 而 不 是 随机 漫步 路 径 。 要 隐藏 坐 


标 轴 ， 可 使 用 如 下 代码 : 


rw_Vvisual.py 


--5170-- 
while True: 
-- Snip-- 


s=100) 
隐藏 坐标 轴 


© plt.axes().get xaxis().set visible(False) 
plt.axes().get yaxis().set visible(False) 


plt. show() 
-- Snip-- 


plt.scatter(rw.x values[-1], rw.y values[-1], c='red', edgecolors='none', 


为 修改 坐标 轴 , 使 用 了 函数 plt.axes() ( 见 @ ) 来 将 每 条 坐标 轴 的 可 见 性 都 设置 为 False。 随 


着 你 越 来 越 多 地 进行 数据 可 视 化 ， 经 常会 看 到 这 种 串 接 方法 的 方式 。 


如 果 你 现在 运行 rw_visual.py， 将 看 到 一 系列 图 形 ， 但 看 不 到 坐标 轴 。 


15.3.9 增加 点 数 


下 面 来 增加 点 数 ， 以 提供 更 多 的 数据 。 为 此 ， 我 们 在 创建 RandomWalk 实 例 时 增 大 num_points 


的 值 ， 并 在 绘图 时 调整 每 个 点 的 大 小 ， 如 下 所 示 : 


rw_Vvisual.py 


-- SNip-- 

while True: 
# 创 建 一 个 RandomWalk 实 例 ， 并 将 其 包含 的 点 都 绘制 出 来 
rw = RandomWalk(50000) 
rw.fill walk() 


# 绘制 点 并 将 图 形 显示 出 来 


point numbers = list(range(rw.num points)) 
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plt.scatter(rw.x values, rw.y values, c=point numbers, cmap=plt.cm.Blues, 
edgecolor='none' ,s=1) 
-- SNip-- 


这 个 示例 模拟 了 一 次 包含 50 000 个 点 的 随机 漫步 ( 以 模拟 现实 情况 )， 并 将 每 个 点 的 大 小 都 
设置 为 1。 最 终 的 随机 漫步 图 更 纤细 ， 犹 如 云 人 条， 如 图 15-10 所 示 。 正 如 你 看 到 的 ， 我 们 使 用 简单 
的 散 点 图 制作 出 了 一 件 艺术 品 ! 

请 尝试 修改 上 述 代码 , 看 看 将 漫步 包含 的 点 数 增加 到 多 少 后 , 程序 的 运行 速度 变 得 极其 缓慢 
或 绘制 出 的 图 形变 得 很 难看 。 


图 15-10 ”包含 50 000 个 点 的 随机 漫步 


15.3.10 ”调整 尺寸 以 适合 屏幕 


图 表 适 合 屏幕 大 小 时 , 更 能 有 效 地 将 数据 中 的 规律 呈现 出 来 ,为 让 绘图 窗口 更 适合 屏幕 大 小 ， 
可 像 下 面 这 样 调整 matplotlib 输 出 的 尺寸 : 


rw_visual.py 


-- Snip-- 

while True: 
# 创建 一 个 RandomWalk 实 例 ， 并 将 其 包含 的 点 都 绘制 出 来 
rw = RandomWalk() 
rw.fill walk() 


# 设置 绘图 窗口 的 尺寸 
plt.figure(figsize=(10, 6)) 
-- Snip-- 
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函数 figure() 用 于 指定 图 表 的 宽度 、 高 度 、 分 辨 率 和 背景 色 。 你 需要 给 形 参 figsize 指 定 一 个 
元 组 ， 向 matplotlib 指 出 绘图 窗口 的 尺寸 ， 单 位 为 英寸 。 

Python 假定 屏幕 分 辩 率 为 80 像 素 /英寸 , 如 果 上 述 代码 指定 的 图 表 尺 寸 不 合适 , 可 根据 需要 调 
整 其 中 的 数字 。 如 果 你 知道 自己 的 系统 的 分 辨 率 ， 可 使 用 形 参 dpi 向 figure() 传 递 该 分 辨 率 ， 以 
有 效 地 利用 可 用 的 屏幕 空间 ， 如 下 所 示 : 


plt.figure(dpi=128, figsize=(10, 6)) 


动手 试 一 

15-3 分 子 运动 : 修改 rw_visual.py, 将 其 中 的 plt.scatter() 替 换 为 plt.plot()。 为 
模拟 花粉 在 水 滴 表 面 的 运动 路 径 ， 向 plt.plot() 传 递 rw.x values 和 rw.y values， 并 
指定 实 参 值 linewidth。 使 用 5000 个 点 而 不 是 50 000 个 点 。 

15-4 改进 的 随机 漫步 : 在 类 RandomWalk 中 ，x step 和 y step 是 根据 相同 的 条 件 生 
成 的 : 从 列表 [1，-1] 中 随机 地 选择 方向 ， 并 从 列表 [0，1，2，3，4] 中 随机 地 选择 距离 。 
请 修改 这 些 列表 中 的 值 ,看 看 对 随机 漫步 路 径 有 何 影 响 。 尝 试 使 用 更 长 的 距离 选择 列表 ， 
如 0~8; 或 者 将 -1 从 x 或 了 方向 列表 中 删除 。 

1S-S 重 构 : 方法 fill walk() 很 长 。 请 新 建 一 个 名 为 get_step() 的 方法 ， 用 于 确定 
每 次 漫步 的 距离 和 方向 ， 并 计算 这 次 漫步 将 如 何 和 移动。 然后， 在 fill walk() 中 调用 
get step() 两 次 : 


x step = get step() 
y step = get step() 


通过 这 样 的 重 构 ,可 缩小 fill walk() 的 规模 ,让 这 个 方法 阅读 和 理解 起 来 更 容易 。 


15.4 ”使 用 Pygal 模拟 搓 般 子 


在 本 节 中 , 我 们 将 使 用 Python 可 视 化 包 Pygal 来 生成 可 缩放 的 矢量 图 形 文件 。 对 于 需要 在 尺寸 
不 同 的 屏幕 上 显示 的 图 表 ,， 这 很 有 用 ,因为 它们 将 自动 缩放 ， 以 适合 观看 者 的 屏幕 。 如 果 你 打算 
以 在 线 方式 使 用 图 表 , 请 考虑 使 用 Pygal 来 生成 它们 ， 这样 它 们 在 任何 设备 上 显示 时 都 会 很 美观 。 

在 这 个 项 目 中 ， 我 们 将 对 掷 蜗 子 的 结果 进行 分 析 。 掷 6 面 的 常规 蜗 子 时 ， 可 能 出 现 的 结果 为 
1~6 点 ， 且 出 现 每 种 结果 的 可 能 性 相同 。 然 而 ， 如 果 同 时 掷 两 个 仙 子 ， 某 些 点 数 出 现 的 可 能 性 将 
比 其 他 点 数 大 。 为 确定 哪些 点 数 出 现 的 可 能 性 最 大 ， 我 们 将 生成 一 个 表示 掷 蜗 子 结果 的 数据 集 ， 
并 根据 结果 绘制 出 一 个 图 形 。 

在 数学 领域 ,常常 利用 掷 骨 子 来 解释 各 种 数据 分 析 , 但 它 在 赌场 和 其 他 博弈 场景 中 也 得 到 了 


Whl 
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实际 应 用 ， 在 游戏 《大 富翁 》 以 及 众多 角色 扮演 游戏 中 亦 如 此 。 
15.4.1 安装 Pygal 


请 使 用 pip 来 安装 Pygal ( 如 果 还 未 使 用 过 pip ， 请 参阅 12.2.1 节 )。 
在 Linux 和 OS X 系 统 中 ， 应 执行 的 命令 类 似 于 下 面 这 样 : 


pip install --user pygal 


在 Windows 系 统 中 ,命令 类 似 于 下 面 这 样 : 


python -m pip install --user pygal 


注意 ”你 可 能 需要 使 用 命令 pip3 而 不 是 pip， 如 果 这 还 是 不 管用 ， 你 可 能 需要 删除 标志 --User。 


15.4.2 ”Pygal 画廊 


要 了 解 使 用 Pygal 可 创建 什么 样 的 图 表 , 请 查看 图 表 类 型 画廊 : 访问 http:/www.pygal.org/, 单 
击 Documentation, 再 单 击 Chart types。 每 个 示例 都 包含 源 代码 , 让 你 知道 这 些 图 表 是 如 何 生成 的 。 


15.4.3 创建 Die 类 
下 面 的 类 模拟 掷 一 个 货 子 : 
die.py 


from random import randint 


class Die(): 
"" "表示 一 个 殿 子 的 类 """ 


© def init (self, num sides=6): 
Tin 锋 子 默认 为 6 面 """ 
self.num sides = num sides 


def roll(self): 
""" "返回 一 个 位 于 1 和 租 子 面 数 之 间 的 随机 值 '"" 
@ return randint(1, self.num sides) 


方法 _init _() 接 受 一 个 可 选 参 数 。 创 建 这 个 类 的 实例 时 ， 如 果 没 有 指定 任何 实 参 ， 面 数 默 
认为 6; 如 果 指 定 了 实 参 ， 这 个 值 将 用 于 设置 角子 的 面 数 ( 见 @ )。 骨 子 是 根据 面 数 命名 的 ，6 面 
的 骨 子 名 为 D6，8 面 的 骨 子 名 为 D8， 以 此 类 推 。 

方法 rol1() 使 用 函数 randint() 来 返回 一 个 1 和 面 数 之 间 的 随机 数 ( 见 @ )。 这 个 函数 可 能 返回 
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起 始 值 1、 终 止 值 num_sides 或 这 两 个 值 之 间 的 任何 整数 。 


15.4.4 ” 据 般 子 
使 用 这 个 类 来 创建 图 表 前 ， 先 来 掷 D6 蜗 子 ， 将 结果 打印 出 来 ， 并 检查 结果 是 否 合 理 : 


die_visual.py 


from die import Die 


# 创建 一 个 D6 
@ die = Diel() 


# 据 几 次 明子 ， 并 将 结果 存储 在 一 个 列表 中 
results = [] 
@ for roll num in range(100): 
result = die.roll() 
results.append(result) 


print(results) 


在 @ 人 处, 我们 创建 了 一 个 Die 实 例 ， 其 面 数 为 默认 值 6。 在 @ 处 ,我 们 撕 骨 子 100 次 ,并 将 每 次 
的 结果 都 存储 在 列表 results 中 。 下 面 是 一 个 示例 结果 和 集 : 


[4， 6， 5， 65 1， 5， 6， 3， 5， 3， 5， 3， 2， 2， 1， 3， 1， 3 35 6， 3 6， 5 4， 
1， 1， 4， 3， 6， 4， 2， 6， 4， 15 3， 25 5 6， 3， 6， 2 人 5 15 3， 4， 15 4， 
3， 5 4 4， 5， 5， 3， 3， 13 2， 3， 5， 6， 2， 5， 6， 1 3， 2， 2 1 4 6， 

SN 光 和 23055 336 35 


5， 53 2 2， 6， 4， 1， 4， 5， 1， 1， 1， 4， 
2 


通过 快速 扫描 这 些 结果 可 知 ，Die 类 看 起 来 没有 问题 。 我 们 见 到 了 值 1/ 和 6， 这 表明 返回 了 最 
大 和 最 小 的 可 能 值 ; 我 们 没有 见 到 0 或 7， 这 表明 结果 都 在 正确 的 范围 内 。 我 们 还 看 到 了 1~6 的 所 
有 数字 ， 这 表明 所 有 可 能 的 结果 都 出 现 了 。 


15.4.5 ”分析 结果 
为 分 析 掷 一 个 D6 蜗 子 的 结果 ， 我 们 计算 每 个 点 数 出 现 的 次 数 : 


die_visual.py 


-- SNip-- 
# 挪 几 次 明子 ， 并 将 结果 存储 在 一 个 列表 中 
results = [|] 
@ for roll num in range(1000): 
result = die.roll() 
results.append(result) 


# 分 析 结 果 
frequencies = [] 
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@ for value in range(1, die.num sides+1): 


(3 frequency = results.count(value) 
@ frequencies.append(frequency) 
print(frequencies) 


由 于 我 们 将 使 用 Pygal 来 进行 分 析 ， 而 不 是 将 结果 打印 出 来 ， 因 此 可 以 将 模拟 撕 山子 的 次 数 
增加 到 1000 ( 见 @ )。 为 分 析 结 果 ， 我 们 创建 了 空 列表 frequencies ， 用 于 存储 每 种 点 数 出 现 的 次 
数 。 在 @ 处 , 我 们 遍历 可 能 的 点 数 ( 这 里 为 1~6 ), 计算 每 种 点 数 在 results 中 出 现 了 多 少 次 ( 见 @ )， 
并 将 这 个 值 附加 到 列表 frequencies 的 末尾 ( 见 @ )。 接 下 来 ， 我们 在 可 视 化 之 前 将 这 个 列表 打印 
出 来 : 


[155, 167, 168, 170, 159,181] 


结果 看 起 来 是 合理 的 : 我 们 看 到 了 6 个 值 一 一 扼 D6 货 子 时 可 能 出 现 的 每 个 点 数 对 应 一 个 ; 我 
们 还 发 现 ， 没 有 任何 点 数 出 现 的 频率 比 其 他 点 数 高 很 多 。 下 面 来 可 视 化 这 些 结果 。 


15.4.6 ”绘制 直方 图 


有 了 频率 列表 后 ,我们 就 可 以 绘制 一 个 表示 结果 的 直方 图 。 直 方 图 是 一 种 条 形 图 ,指出 了 各 
种 结果 出 现 的 频率 。 创 建 这 种 直方 图 的 代码 如 下 : 


die_visual.py 


import pygal 


-- SNip-- 


# 分 析 结 果 

frequencies = [ 

for value in range(1, die.num sides+1) : 
frequency = results.count(value) 
frequencies.append(frequency) 


# 对 结果 进行 可 视 化 
@ hist = pygal.Bar() 


hist.title = "Results of rolling one D6 1000 times." 
@ hist.x labels = ['1', '2', '3', '4', '5', '6'] 

hist.x title = "Result" 

hist.y title = "Frequency of Result" 


@ hist.add('D6', frequencies) 
hist.render to file('die visual.svg') 


为 创建 条 形 图 ， 我 们 创建 了 一 个 pygal.Bar() 实 例 ， 并 将 其 存储 在 hist 中 ( 见 @ )。 接 下 来 ， 
我 们 设置 hist 的 属性 title (用 于 标示 直方 图 的 字符 串 )， 将 搓 D6 禹 子 的 可 能 结果 用 作 x 轴 的 标签 
( 见 @ ), 并 给 每 个 轴 都 添加 了 标题 。 在 四 处 ,我们 使 用 add() 将 一 系列 值 添加 到 图 表 中 (向 它 传递 


| 
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要 给 添加 的 值 指定 的 标签 ， 还 有 一 个 列表 ， 其 中 包含 将 出 现在 图 表 中 的 值 )。 最 后 ， 我 们 将 这 个 
图 表 泻 染 为 一 个 SVG 文件 ， 这 种 文件 的 扩展 名 必须 为 .svg。 

要 查看 生成 的 直方 图 ， 最 简单 的 方式 是 使 用 Web 浏 览 嚣 。 为 此 ， 在 任何 Web 浏 览 器 中 新 建 一 
个 标签 页 ， 再 在 其 中 打开 文件 die_visualsvg ( 它 位 于 die_visual.py 所 在 的 文件 夹 中 )。 你 将 看 到 一 
个 类 似 于 图 15-11 所 示 的 图 表 ( 为 方便 印刷 ， 我 稍微 修改 了 这 个 图 表 ; 默认 情况 下 ，Pygal 生 成 的 
图 表 的 背景 比 你 在 图 15-11 中 看 到 的 要 上 暗 )。 


€ » © |B fle///home/ehmatthes/pcc/chapter_15/dice_visualsvg ne 


Results of rolling one D6 1000 times. 


D6 


Frequency of Result 


Result 


图 15-11 ”使 用 Pygal 创 建 的 简单 条 形 图 
注意 ，Pygal 让 这 个 图 表 具 有 交互 性 : 如 果 你 将 鼠标 指向 该 图 表 中 的 任何 条 形 ， 将 看 到 与 之 
相关 联 的 数据 。 在 同一 个 图 表 中 绘制 多 个 数据 集 时 ， 这 项 功能 显得 特别 有 用 。 
15.4.7 ”同时 掷 两 个 般 子 


同时 搓 两 个 贷 子 时 ， 得 到 的 点 数 更 多 ,结果 分 布 情况 也 不 同 。 下 面 来 修改 前 面 的 代码 ， 创 建 5 
两 个 D6 般 子 ， 以 模拟 同时 掷 两 个 仍 子 的 情况 。 每 次 掷 两 个 台 子 时 ， 我 们 都 将 两 个 仍 子 的 点 数 相 
加 ,并 将 结果 存储 在 results 中 。 请 复制 die_visual.py 并 将 其 保存 为 dice_visual.py， 青 做 如 下 修改 : 


dice_visual.py 


import pygal 
from die import Die 
# 创建 两 个 D6 乳 子 


die 1 = Die() 
die 2 = Die() 
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# 拨 典 子 多 次 ， 并 将 结果 存储 到 一 个 列表 中 
results = [|] 
for roll num in range(1000): 
© result = die 1.r01l1l() + die 2.r011() 
results.append(result) 


# 分 析 结 果 
frequencies = [] 
@ max result = die 1.num sides + die 2.num sides 
@ for value in range(2, max result+1): 
frequency = results.count(value) 
frequencies.append(frequency) 


# 可 视 化 结果 


hist = pygal.Bar() 


@ hist.title = "Results of rolling two D6 dice 1000 times." 

hist.x labels = ['2', '3', "4', '5'’, '6', '7', '8', '9', '10', '11', '12'] 
hist.x title = "Result" 

hist.y title = "Frequency of Result" 


hist.add('D6 + D6', frequencies) 
hist.render to file('dice visual.svg') 


创建 两 个 Die 实 例 后， 我 们 掷 蜗 子 多 次 ， 并 计算 每 次 的 总 点 数 ( 见 @)。 可 能 出 现 的 最 大 点 数 
12 为 两 个 散 子 的 最 大 可 能 点 数 之 和 , 我 们 将 这 个 值 存储 在 了 max_result 中 ( 见 @ )。 可 能 出 现 的 最 
小 总 点 数 2 为 两 个 骨 子 的 最 小 可 能 点 数 之 和 。 分 析 结 果 时 ,我 们 计算 2 到 max_result 的 各 种 点 数 出 
现 的 次 数 ( 见 @ )。 我 们 原本 可 以 使 用 range(2，13)， 但 这 只 适用 于 两 个 D6 骨 子 。 模 拟 现实 世界 
的 情形 时 , 最 好 编写 可 轻松 地 模拟 各 种 情形 的 代码 。 前 面 的 代码 让 我 们 能 够 模拟 拂 任 何 两 个 骨 子 
的 情形 ， 而 不 管 这 些 散 子 有 多 少 面 。 

创建 图 表 时 , 我 们 修改 了 标题 、x 轴 标签 和 数据 系列 ( 见 @ )。( 如 果 列 表 x_labels 比 这 里 所 示 
的 长 得 多 ， 那么 编写 一 个 循环 来 自动 生成 它 将 更 合适 。) 

运行 这 些 代 码 后 ， 在 浏览 带 中 刷新 显示 图 表 的 标签 页 ， 你 将 看 到 如 图 15-12 所 示 的 图 表 。 


这 个 图 表 显 示 了 掷 两 个 D6 般 子 时 得 到 的 大 致 结果 。 正 如 你 看 到 的 ， 总 点 数 为 2 或 12 的 可 能 
最 小 ， 而 总 点 数 为 7 的 可 能 性 最 大 ， 这 是 因为 在 6 种 情况 下 得 到 的 总 点 数 都 为 7。 这 6 种 情况 如 下 : 


1 和 6、2 和 5、3 和 4、4 和 3、5 和 2、6 和 1。 
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[9 Results ofrolling 
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Results of rolling two D6 dice 1000 times. 


aD6 + D6 loo 


Frequency of Result 


有 ”和 7 8 ,9 49 11 12 


Result 


图 15-12 ”模拟 同时 找 两 个 6 面 骨 子 1000 次 的 结果 


15.4.8 同时 据 两 个 面 数 不 同 的 般 子 
下 面 来 创建 一 个 6 面 仙 子 和 一 个 10 面 山子 ， 看 看 同时 掷 这 两 个 仍 子 50 000 次 的 结果 如 何 : 
different_ dice.py 


from die import Die 
import pygal 
# 创建 一 个 D6 和 一 个 D10 


die 1 = Die() 
@ die 2 = Die(10) 


# 拨 贷 子 多 次 ， 并 将 结果 存储 在 一 个 列表 中 
results = [| 
for roll num in range(50000): 
result = die 1.r01l1l() + die 2.r011() 
results.append(result) 


# 分 析 结 果 
-- SNip-- 


# 可 视 化 结果 
hist = pygal.Bar() 


@ hist.title = "Results of rolling a D6 and a D10 50,000 times.' 
hist.x labels = [12', 3', "4, ‘5', '6', ‘7', '8', '9', 110', ‘11', '12', 
"3 出世 “15 ， '16'] 
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hist.x title = "Result" 
hist.y title = "Frequency of Result" 


hist.add('D6 + D10', frequencies) 
hist.render to file('dice visual.svg') 


为 创建 D10 骨 子 ， 我们 在 创建 第 二 个 Die 实 例 时 传递 了 实 参 10( 见 @ )。 我 们 还 修改 了 第 一 个 
循环 ， 以 模拟 搓 仍 子 50 000 次 而 不 是 1000 次 。 可 能 出 现 的 最 小 总 点 数 依然 是 >-， 但 现在 可 能 出 现 
的 最 大 总 点 数 为 6， 因 此 我 们 相应 地 调整 了 标题 、x 轴 标签 和 数据 系列 标签 ( 见 @ )。 

图 15-13 显 示 了 最 终 的 图 表 。 可 能 性 最 大 的 点 数 不 是 一 个 ,而 是 5 个 ,这 是 因为 导致 出 现 最 小 
点 数 和 最 大 点 数 的 组 合 都 只 有 一 种 (1 和 1 以 及 6 和 10 ), 但 面 数 较 小 的 山 子 限制 了 得 到 中 间 点 数 的 
组 合 数 : 得 到 总 点 数 7、8、9、10 和 11 的 组 合 数 都 是 6 种 。 因 此 ， 这 些 总 点 数 是 最 常见 的 结果 ， 它 
们 出 现 的 可 能 性 相同 。 


€ » © [BD file///home/ehmatthes/pcc/chapter_15/dice_visualsvg 
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图 15-13 ”同时 措 6 面 贷 子 和 10 面 山子 50 000 次 的 结果 


通过 使 用 Pygal 来 模拟 掷 般 子 的 结果 ， 能 够 非常 自由 地 探索 这 种 现象 。 只 需 几 分 钟 ， 就 可 以 
搓 各 种 仍 子 很 多 次 。 


动手 试 一 斌 
15-6 自动 生成 标签 : 请 修改 die.py 和 dice _ visual.py， 将 用 来 设置 hist.x labels 值 


的 列表 替换 为 一 个 自动 生成 这 种 列表 的 循环 。 如 果 你 熟悉 列表 解析 ， 可 尝试 将 
die_visual.py 和 dice_visual.py 中 的 其 他 for 循环 也 替换 为 列表 解析 。 
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15-7 两 个 D8 鹏 子 : 请 模拟 同时 括 两 个 8 面 贷 子 1000 次 的 结果 。 逐 渐 增 加 捕 股 子 
的 次 数 ， 直 到 系统 不 堪 重 负 为 止 。 

15-8 同时 丘 三 个 股子 : 如 果 你 同时 所 三 个 D6 朋 子 ， 可 能 得 到 的 最 小 点 数 为 3， 而 
最 大 点 数 为 18。 请 通过 可 视 化 展示 同时 搓 三 个 D6 山子 的 结果 。 

15-9 将 点 数 相 乘 : 同时 捕 两 个 咒 子 时 ， 通 常 将 它们 的 点 数 相 加 。 请 通过 可 视 化 展 
示 将 两 个 鹏 子 的 点 数 相 乘 的 结果 。 

15-10 练习 使 用 本 章 介绍 的 两 个 库 : 尝试 使 用 matplotlib 通过 可 视 化 来 模拟 搬 股 子 
的 情况 ， 并 尝试 使 用 Pygal 通过 可 视 化 来 模拟 随机 漫步 的 情况 。 


15.5 小结 


在 本 章 中 , 你 学 习 了 : 如 何 生 成 数据 集 以 及 如 何 对 其 进行 可 视 化 ; 如 何 使 用 matplotlib 创 建 
单 的 图 表 ， 以 及 如 何 使 用 散 点 图 来 探索 随机 漫步 过 程 ， 如 何 使 用 Pygal 来 创建 直方 图 ， 以 及 如 
使 用 直方 图 来 探索 同时 掷 两 个 面 数 不 同 的 仍 子 的 结 

使 用 代码 生成 数据 集 是 一 种 有 趣 而 强大 的 方式 , 可 用 于 模拟 和 探索 现实 世界 的 各 种 情形 。 
成 后 面 的 数据 可 视 化 项 目 时 , 请 注意 可 使 用 代码 模拟 哪些 情形 。 请 研究 新 闻 媒 体 中 的 可 视 化 ， 
看 其 中 是 否 有 图 表 是 以 你 在 这 些 项 目 中 学 到 的 类 似 方式 生成 的 。 

在 第 16 音 中， 我们 将 从 网 上 下 载 数据 ， 并 继续 使 用 matplotlib 和 Pygal 来 探索 这 些 数 据 。 


简 


何 


元 


下 载 数据 


在 本 章 中 , 你 将 从 网 上 下 载 数据 ， 并 对 这 些 数 据 进行 可 视 化 。 网 
上 的 数据 多 得 难以 置信 , 且 大 多 未 经 过 仔细 检查 。 如 果 能 够 对 这 些 数 
据 进 行 分 析 ， 你 就 能 发 现 别人 没有 发 现 的 规律 和 关联 。 

我 们 将 访问 并 可 视 化 以 两 种 常见 格式 存储 的 数据 : CSV 和 JSON。 
我 们 将 使 用 Python 模块 csv 来 处 理 以 CSV (逗号 分 隔 的 值 ) 格式 存储 
的 天 气 数 据 ， 找 出 两 个 不 同 地 区 在 一 段 时 间 内 的 最 高 温度 和 最 低温 
度 。 然 后 ， 我 们 将 使 用 matplotlib 根 据 下 载 的 数据 创建 一 个 图 表 ， 展 
示 两 个 不 同 地 区 的 气温 变化 : 阿拉 斯 加 锡 特 卡 和 加 利 福 尼 亚 死亡 谷 。 
在 本 章 的 后 面 ， 我 们 将 使 用 模块 json 来 访问 以 JSON 格 式 存储 的 人 口 
数据 ， 并 使 用 Pygal 绘 制 一 幅 按 国 别 划分 的 人 口 地 图 。 

阅读 本 章 后 ， 你 将 能 够 处 理 各 种 类 型 和 格式 的 数据 集 ， 并 对 如 何 创 建 复杂 的 图 表 有 更 
深入 的 认识 。 要 处 理 各 种 真实 世界 的 数据 集 ， 必 须 能 够 访问 并 可 视 化 各 种 类 型 和 格式 的 在 
线 数据 。 


16.1 CSV 文件 格式 


要 在 文本 文件 中 存储 数据 ， 最 简单 的 方式 是 将 数据 作为 一 系列 以 过 号 分 隔 的 值 (CSV ) 写 人 
文件 。 这 样 的 文件 称 为 CSV 文 件 。 例 如 ， 下 面 是 一 行 CSV 格 式 的 天 气 数据 : 


2014-1-5,61,44,26,18,7,-1,56,30,9,30.34,30.27,30.15,,,,10,4,,0.00,0, ,195 


这 是 阿拉 斯 加 锡 特 卡 2014 年 1 月 5 日 的 天 气 数据 , 其 中 包含 当天 的 最 高 气温 和 最 低 气 温 , 还 有 
众多 其 他 数据 。CSV 文 件 对 人 来 说 阅读 起 来 比较 麻烦 , 但 程序 可 轻松 地 提取 并 处 理 其 中 的 值 ， 这 
有 助 于 加 快 数据 分 析 过 程 。 

我 们 将 首先 处 理 少量 锡 特 卡 的 CSV 格 式 的 天 气 数据 ， 这 些 数 据 可 在 本 书 的 配套 资源 
( https://www.nostarch.com/pythoncrashcourse/ ) 中 找到 。 请 将 文件 sitka_weather 07-2014.csv 复 制 到 
存储 本 章程 序 的 文件 夹 中 (下 载 本 书 的 配套 资源 后 ， 你 就 有 了 这 个 项 目 所 需 的 所 有 文件 )。 
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注意 ”这 个 项 目 使 用 的 天 气 数据 是 从 http:/www.wunderground.com/history/ 下 载 而 来 的 。 


16.1.1 分 析 CSV 文件 头 


csv 模 块 包含 在 Python 标 准 库 中 , 可 用 于 分 析 CSV 文 件 中 的 数据 行 , 让 我 们 能 够 快速 提取 感 兴 
趣 的 值 。 下 面 先 来 查看 这 个 文件 的 第 一 行 ， 其 中 包含 一 系列 有 关 数 据 的 描述 : 


highs_lows.py 


import csv 


filename = 'sitka weather 07-2014.CSV 
@ with open(filename) as f: 
(2 reader = csv.reader(f) 
(3 header row = next(reader) 
print(header row) 


导入 模块 csv 后 ,我 们 将 要 使 用 的 文件 的 名 称 存储 在 filename 中 。 接 下 来 ,我 们 打开 这 个 文 
件 ， 并 将 结果 文件 对 象 存储 在 f 中 ( 见 @ )。 然 后 ， 我 们 调用 csv.reader()， 并 将 前 面 存储 的 文件 
对 象 作为 实 参 传递 给 它 ， 从 而 创建 一 个 与 该 文件 相关 联 的 阅读 器 〈reader ) 对 象 ( 见 @ )。 我 们 
将 这 个 阅读 器 对 象 存 储 在 reader 中 。 

模块 csv 包 含水 数 next()， 调 用 它 并 将 阅读 器 对 和 象 传递 给 它 时 ， 它 将 返回 文件 中 的 下 一 行 。 
在 前 面 的 代码 中 ,我 们 只 调用 了 next() 一 次 ， 因 此 得 到 的 是 文件 的 第 一 行 ， 其 中 包含 文件 涉 ( 见 
@ )。 我 们 将 返回 的 数据 存储 在 header row 中 。 正 如 你 看 到 的 ，header row 包 含 与 天 气相 关 的 文件 
头 ， 指 出 了 每 行 都 包含 哪些 数据 : 

['AKDT', "Max TemperatureF', "Mean TemperatureF', 'Min TemperatureF ' ， 

'Max Dew PointF', 'MeanDew PointF', "Min DewpointF', "Max Humidity ， 

”Mean Humidity', ' Min Humidity', ' Max Sea Level PressureIn', 

”Mean Sea Level PressureIn', ' Min Sea Level PressureIn ， 

”Max VisibilityMiles', ' Mean VisibilityMiles', ' Min VisibilityMiles ， 

”Max Wind SpeedMPH', ' Mean Wind SpeedMPH', ' Max Gust SpeedMPH ， 

'PrecipitationIn', ' CloudCover', ' Events', ' WindDirDegrees'] 


reader 处 理 文件 中 以 逗号 分 隔 的 第 一 行 数据 ， 并 将 每 项 数据 都 作为 一 个 元 素 存 储 在 列表 中 。 
文件 头 AKDT 表 示 阿 拉 斯 加 时 间 ( Alaska Daylight Time )， 其 位 置 表 明 每 行 的 第 一 个 值 都 是 日 期 或 
时 间 。 文 件 头 Max TemperatureF 指 出 每 行 的 第 二 个 值 都 是 当天 的 最 高 华氏 温度 。 可 通过 阅读 其 他 
的 文件 头 来 确定 文件 包含 的 信息 类 型 。 


注意 文件 头 的 格式 并 非 总 是 一 致 的 ， 空 格 和 单位 可 能 出 现在 奇怪 的 地 方 。 这 在 原始 数据 文件 
中 很 常见 » 但 不 会 带 来 任何 问题 。 
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16.1.2 ”打印 文件 头 及 其 位 置 
为 让 文件 头 数据 更 容易 理解 ， 将 列表 中 的 每 个 文件 头 及 其 位 置 打印 出 来 : 
highs_lows.py 


1/ 


-- Snip-- 

with open(filename) as f: 
reader = csv.reader(f) 
header row = next(reader) 


@ for index, column header in enumerate(header row) 
print(index, column header) 


我 们 对 列表 调用 了 enumerate()( 见 @ ) 来 获取 每 个 元 素 的 索引 及 其 值 。( 请 注意 ， 我 们 删除 
了 代码 行 print(header row) ， 转 而 显示 这 个 更 详细 的 版 本 。) 
输出 如 下 ， 其 中 指出 了 每 个 文件 头 的 索引 : 


0 AKDT 

1 Max TemperatureF 

2 Mean TemperatureF 
3 Min TemperatureF 

-- Ship-- 

20 CloudCover 

21 Events 

22 WindDirDegrees 


从 中 可 知 ， 日 期 和 最 高 气温 分 别 存储 在 第 0 列 和 第 1 列 。 为 研究 这 些 数 据 ， 我 们 将 处 理 
sitka_weather_ 07-2014.csv 中 的 每 行 数 据 ， 并 提取 其 中 索引 为 0 和 1 的 值 。 


16.1.3 ”提取 并 读 取 数 据 


知道 需要 哪些 列 中 的 数据 后 ， 我 们 来 读 取 一 些 数据 。 首 先 读 取 每 天 的 最 高 气温 : 
highs_lows.py 


import csv 


# 从 文件 中 获取 最 高 气温 
filename = 'sitka weather 07-2014.CSV 
with open(filename) as f: 

reader = csv.reader(f) 

header row = next(reader) 


highs = [] 
for row in reader: 
highs.append(row[1]) 


©O®O® 


print(highs) 
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我 们 创建 了 一 个 名 为 highs 的 空 列表 ( 见 @ )， 再 遍历 文件 中 余下 的 各 行 ( 见 @ )。 阅读 器 对 象 
从 其 停留 的 地 方 继续 往 下 读 取 CSV 文 件 , 每 次 都 自动 返回 当前 所 处 位 置 的 下 一 行 。 由 于 我 们 已 经 
读 取 了 文件 头 行 , 这 个 循环 将 从 第 二 行 开 始 一 一 从 这 行 开 始 包 含 的 是 实际 数据 。 每 次 执行 该 循环 
时 ,我 们 都 将 索引 1 处 ( 第 2 列 ) 的 数据 附加 到 highs 末 尾 ( 见 @ )。 
下 面 显示 了 highs 现 在 存储 的 数据 : 
[2 Tg 04 By O90 2 Ol 505 oy OD OT N09 97 
61, "G4, 61, "59" "63 "60!, "7 69 63" 62 590 D7 D7 ey 
'61', '59','61','61',，'66'] 
我 们 提取 了 每 天 的 最 高 气温 ， 并 将 它们 作为 字符 串 整 洁 地 存储 在 一 个 列表 中 。 
下 面 使 用 int() 将 这 些 字符 串 转 换 为 数字 ， 计 matplotlib 能 够 读 取 它们 : 
highs_lows.py 


-- Ship-- 
highs = [] 
for row in reader: 
© high = int(row[1]) 
highs.append(high) 
print(highs) 
在 @ 处 , 我 们 将 表示 气温 的 字符 串 转 换 成 了 数字 ， 再 将 其 附加 到 列表 末尾 。 这 样 ， 最终 的 列 
表 将 包含 以 数字 表示 的 每 日 最 高 气温 : 


[64, 71, 64, 59, 69, 62, 61, 55, 57, 61, 57, 59, 57, 61, 64, 61, 59, 63, 60,57, 
69, 63, 62, 59, 57, 57, 61, 59, 61, 61,，66] 


下 面 来 对 这 些 数 据 进行 可 视 化 。 
16.1.4 ”绘制 气温 图 表 


为 可 视 化 这 些 气温 数据 , 我 们 首先 使 用 matplotlib 创 建 一 个 显示 每 日 最 高 气温 的 简单 图 形 , 如 
下 所 示 : 


highs_lows.py 


import csv 
from matplotlib import pyplot as plt 


# 从 文件 中 获取 最 高 气温 
--SNip-- 


# 根据 数据 绘制 图 形 
fig = plt.figure(dpi=128, figsize=(10, 6)) 
@ plt.plot(highs, c='red') 
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# 设置 图 形 的 格式 
@ plt.title("Daily high temperatures, July 2014", fontsize=24) 
©@ plt.xlabel('', fontsize=16) 

plt.ylabel("Temperature (F)", fontsize=16) 

plt.tick params(axis="'both', which="'major', labelsize=16) 


plt.show() 


我 们 将 最 高 气温 列表 传 给 plot() ( 见 @ )， 并 传递 c='red ' 以便 将 数据 点 绘制 为 红色 〈 红 色 显 
示 最 高 气温 , 蓝 色 显示 最 低 气 温 )。 接 下 来 , 我 们 设置 了 一 些 其 他 的 格式 ,如 字体 大 小 和 标签 ( 见 
@ ), 这 些 都 在 第 15 章 介绍 过 。 鉴 于 我 们 还 没有 添加 日 期 ,因此 没有 给 x 轴 添加 标签 ,但 plt.xlabel() 
确实 修改 了 字体 大 小 ， 让 默认 标签 更 容易 看 清 。 图 16-1 显 示 了 绘制 的 图 表 : 一 个 简单 的 折线 图 ， 
显示 了 阿拉 斯 加 锡 特 卡 2014 年 7 月 每 天 的 最 高 气温 。 


遍 Daily high temperatures, July 2014 


图 16-1 阿拉 斯 加 锡 特 卡 2014 年 7 月 每 日 最 高 气温 折线 图 


16.1.5 ”模块 datetime 
下 面 在 图 表 中 添加 日 期 ， 使 其 更 有 用 。 在 天 气 数据 文件 中 ， 第 一 个 日 期 在 第 二 行 : 


2014-7-1,64,56,50,53,51,48,96,83,58,30.19,--snip-- 


读 取 该 数据 时 ， 获 得 的 是 一 个 字符 串 ， 因 为 我 们 需要 想 办 法 将 字符 串 '2014-7-1' 转 换 为 一 个 
表示 相应 日 期 的 对 象 。 为 创建 一 个 表示 2014 年 7 月 1 日 的 对 象 ， 可 使 用 模块 datetime 中 的 方法 
strptime()。 我 们 在 终端 会 话 中 看 看 strptime() 的 工作 原理 : 


>>> from datetime import datetime 

>>> first date = datetime.strptime('2014-7-1', '%Y-%m-%d') 
>>> print(first date) 

2014-07-01 00:00:00 
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我 们 首先 导入 了 模块 datetime 中 的 datetime 类 ， 然 后 调用 方法 strptime()， 并 将 包含 所 需 日 
期 的 字符 串 作 为 第 一 个 实 参 。 第 二 个 实 参 告诉 python 如 何 设置 日 期 的 格式 在 这 个 示例 中 ，'%Y-' 
De 符 前 面 的 部 分 视 为 四 位 的 年 份 ; '%m-' 让 Python 将 第 二 个 连 字 符 前 
面 的 部 分 视 为 表示 月 份 的 数字 ; 而 '%d' 让 Python 将 字符 串 的 最 后 一 部 分 视 为 月 份 中 的 一 天 


(1~31 )。 


方法 strptime() 可 接受 各 种 实 参 ， 并 根据 它们 来 决定 如 何 解读 日 期 。 表 16-1 列 出 了 其 中 一 些 


这 样 的 实 参 。 


表 16-1 模块 datetime 中 设置 日 期 和 时 间 格 式 的 实 参 


含义 


%A 
%B 
Xm 
%d 
%Y 
%y 
%H 
%I 
Xp 
NM 
%s 


16.1.6 在 图 表 中 添加 日 期 


知道 如 何 处 理 CSV 文 件 中 的 日 期 后 ， 就 可 对 气温 图 形 进 行 


并 将 它们 传递 给 plot() ， 如 下 所 示 : 
highs_lows.py 


星期 的 名 称 ， 如 Monday 
月 份 名 ， 如 January 

用 数字 表示 的 月 份 (01~12) 
用 数字 表示 月 份 中 的 一 天 (01~31) 
四 位 的 年 份 ， 如 2015 
两 位 的 年 份 ， 如 15 

24 小 时 制 的 小 时 数 (00~23) 
12 小 时 制 的 小 时 数 (01~12) 
am 或 pm 

分 钟 数 (00~59) 

秒 数 (00~61) 


= = 


改进 了 ， 即 提取 日 期 和 最 高 气温 ， 


from datetime import datetime 


# 从 文件 中 获取 日 期 和 最 高 气温 


@ dates, highs = [], [] 


(2 current date = datetime.strptime(row[0], "%Y-%m-%d") 


dates.append(current date) 
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@@ plt.plot(dates, highs, c='red') 


@ fig.autofmt xdate() 


我 们 创建 了 两 个 空 列 表 ， 用 于 存储 从 文件 中 提取 的 日 期 和 最 高 气温 〈 见 @ )。 然 后 ， 我 们 将 
包含 日 期 信息 的 数据 (row[0] ) 转换 为 datetime 对 象 ( 见 @ )， 并 将 其 附加 到 列表 dates 末 尾 。 在 
旨 处 ， 我 们 将 日 期 和 最 高 气温 值 传递 给 plot()。 在 @ 处 ， 我 们 调用 了 fig.autofmt_xdate() 来 绘制 
和 斜 的 日 期 标签 ， 以 免 它 们 彼此 重 羡 。 图 16-2 显 示 了 改进 后 的 图 表 。 
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图 16-2 ”现在 图 表 的 x 轴 上 有 日 期 ， 含 义 更 丰富 


16.1.7 ”涵盖 更 长 的 时 间 


设置 好 图 表 后 ， 我 们 来 添加 更 多 的 数据 ， 以 成 一 幅 更 复杂 的 锡 特 卡 天 气 图 。 请 将 文件 
sitka_weather_ 2014.csv 复 制 到 存储 本 章程 序 的 文件 夹 中 ， 该 文件 包含 Weather Underground 提 供 的 
整 年 的 锡 特 卡 天 气 数 据 。 

现在 可 以 创建 覆盖 整 年 的 天 气 图 了 : 
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highs_lows.py 


-- SNip-- 
# 从 文件 中 获取 日 期 和 最 高 气温 
@ filename = Sitka weather 2014.CSV 
with open(filename) as f: 
-- Snip-- 
# 设置 图 形 的 格式 
@ plt.title("Daily high temperatures - 2014", fontsize=24) 
plt.xlabel('', fontsize=16) 
--SNip-- 


我 们 修改 了 文件 名 ， 以 使 用 新 的 数据 文件 sitka weather 2014.csv ( 见 @ ); 我 们 还 修改 了 图 表 
的 标题 ， 以 反映 其 内 容 的 变化 ( 见 @ )。 图 16-3 显 示 了 生成 的 图 形 。 
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图 16-3 一 年 的 天 气 数据 


16.1.8 ”再 绘制 一 个 数据 系列 


图 16-3 所 示 的 改进 后 的 图 表 显 示 了 大 量 意义 深远 的 数据 , 但 我 们 可 以 在 其 中 再 添加 最 低 气 温 
数据 , 使 其 更 有 用 。 为 此 , 需要 从 数据 文件 中 提取 最 低 气 温 , 并 将 它们 添加 到 图 表 中 , 如 下 所 示 : 


highs_lows.py 


-- SNip-- 
# 从 文件 中 获取 日 期 、 最 高 气温 和 最 低 气 温 
filename = 'sitka weather 2014.csv' 


with open(filename) as f: 
reader = csv.reader(f) 
header row = next(reader) 
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@ dates, highs, lows = [], [], [] 
for row in reader: 
current date = datetime.strptime(row[0], "%Y-%m-%d") 
dates.append(current date) 


high = int(row[1]) 
highs.append(high) 


@ low = int(row[3]) 
lows.append(low) 
# 根据 数据 绘制 图 形 
fig = plt.figure(dpi=128, figsize=(10, 6)) 
plt.plot(dates, highs, c='red') 
@ plt.plot(dates, lows, c='blue') 


# 设置 图 形 的 格式 
@ plt.title("Daily high and low temperatures - 2014", fontsize=24) 
=- Ship-- 


在 @ 处 , 我 们 添加 了 空 列表 lows, 用 于 存储 最 低 气温 。 接 下 来 , 我 们 从 每 行 的 第 4 列 ( row[3] ) 
提取 每 天 的 最 低 气温 ， 并 存储 它们 ( 见 @ ), 在 @@ 处 ,我 们 添加 了 一 个 对 plot() 的 调用 ， 以 使 用 蓝 
色 绘 制 最 低 气 温 。 最 后 ， 我 们 修改 了 标题 ( 见 @ )。 图 16-4 显 示 了 这 样 绘制 出 来 的 图 表 。 
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图 16-4 在 一 个 图 表 中 包含 两 个 数据 系列 


16.1.9 ”给 图 表 区 域 着 色 


添加 两 个 数据 系列 后 ,我 们 就 可 以 了 解 每 天 的 气温 范围 了 。 下面 来 给 这 个 图 表 做 最 后 的 修饰 ， 
通过 着 色 来 呈现 每 天 的 气温 范围 。 为 此 , 我 们 将 使 用 方法 fi]1_between(), 它 接受 一 个 x 值 系列 和 
两 个 y 值 系列 ， 并 填充 两 个 y 值 系列 之 间 的 空间 : 
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highs_lows.py 


-- Snip-- 
# 根据 数据 绘制 图 形 
fig = plt.figure(dpi=128, figsize=(10, 6)) 
@ plt.plot(dates, highs, c='red', alpha=0.5) 
plt.plot(dates, lows, c='blue', alpha=0.5) 
@ plt.fill between(dates, highs, lows, facecolor='blue', alpha=0.1) 
-- Snip-- 


@ 处 的 实 参 alpha 指 定 颜色 的 透明 度 。Alpha 值 为 0 表示 完全 透明 ，1 ( 默认 设置 ) 表示 完全 不 
透明 。 通 过 将 alpha 设 置 为 0.5， 可 让 红色 和 蓝 色 折线 的 颜色 看 起 来 更 浅 。 

在 @ 处 ,我 们 向 fill]_ between() 传 递 了 一 个 x 值 系 列 : 列表 dates, 还 传递 了 两 个 y 值 系列 : highs 
和 lows。 实 参 facecolor 指 定 了 填充 区 域 的 颜色 ， 我 们 还 将 alpha 设 置 成 了 较 小 的 值 0.1， 让 填充 区 
域 将 两 个 数据 系列 连接 起 来 的 同时 不 分 散 观 察 者 的 注意 力 。 图 16-5 显 示 了 最 高 气温 和 最 低 气 温 之 
间 的 区 域 被 填充 的 图 表 。 
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图 16-5 ”给 两 个 数据 集 之 间 的 区 域 着 色 
通过 着 色 ， 让 两 个 数据 集 之 间 的 区 域 显而易见 。 


16.1.10 ”错误 检查 


我 们 应 该 能 够 使 用 有 关 任 何 地 方 的 天 气 数据 来 运行 highs_lows.py 中 的 代码 , 但 有 些 气 象 站 会 
偶尔 出 现 故障 ,未 能 收集 部 分 或 全 部 其 应 该 收集 的 数据 。 缺 失 数据 可 能 会 引发 异常 ， 如 果 不 妥善 
地 处 理 ， 还 可 能 导致 程序 月 溃 。 

例如 ， 我 们 来 看 看 生成 加 利 福 尼 亚 死 亡 谷 的 气温 图 时 出 现 的 情况 。 将 文件 death valley_ 
2014.csv 复 制 到 本 章程 序 所 在 的 文件 夹 ， 青 修改 highs_lows.py， 使 其 生成 死亡 谷 的 气温 图 : 
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highs_lows.py 


-- SNip-- 

# 从 文件 中 获取 日 期 、 最 高 气温 和 最 低 气 温 
filename = 'death valley 2014.CSV 
with open(filename) as f: 


-- Ship-- 


运行 这 个 程序 时 ， 出 现 了 一 个 错误 ， 如 下 述 输 出 的 最 后 一 行 所 示 : 


Traceback (most recent call last): 
File "highs lows.py", line 17, in <module> 
high = int(row[1]) 
ValueError: invalid literal for int() with base 10: "" 


该 traceback 指 出 ，Python 无 法 处 理 其 中 一 天 的 最 高 气温 ， 因 为 它 无 法 将 空 字符 串 ('' ) 转换 
为 整数 。 只 要 看 一 下 death_valley 2014.csv， 就 能 发 现 其 中 的 问题 .: 


2014-2-16, 5335353353333333330.00, 5, -1 


其 中 好 像 没有 记录 2014 年 2 月 16 日 的 数据 ， 表 示 最 高 温度 的 字符 串 为 空 。 为 解决 这 种 问题 ， 
我 们 在 从 CSV 文 件 中 读 取 值 时 执行 错误 检查 代码 ,对 分 析 数 据 集 时 可 能 出 现 的 异常 进行 处 理 ， 如 
下 所 示 : 


highs_lows.py 


-- Snip-- 
# 从 文件 中 获取 日 期 、 最 高 气温 和 最 低 气 温 
filename = 'death valley 2014.csv’' 
with open(filename) as f: 

reader = csv.reader(f) 


header row = next(reader) 
dates, highs, lows = [], [], [] 
for row in reader: 

@ try: 


current date = datetime.strptime(row[0], "%Y-%m-%d") 
high = int(row[1]) 

ow = int(row[3]) 

except ValueError: 


@ print(current date， "missing data ' ) 
else: 
(3 dates.append(current date) 
highs.append(high) 
ows .append(low) 


# 根 据 数 据 绘制 图 形 
--Snip-- 
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@ title = "Daily high and low temperatures - 2014\nDeath Valley, CA" 
plt.title(title, fontsize=20) 
-- SNip-- 


对 于 每 一 行 ， 我们 都 尝试 从 中 提取 日 期 、 最 高 气温 和 最 低 气 温 ( 见 @ )。 只 要 缺失 其 中 一 项 
数据 ，Python 就 会 引发 ValueError 异 常 ， 而 我 们 可 这 样 处 理 : 打印 一 条 错误 消息 ， 指 出 缺失 数据 
的 日 期 ( 见 @ )。 打 印 错误 消息 后 ,循环 将 接着 处 理 下 一 行 。 如 果 获 取 特 定 日 期 的 所 有 数据 时 没 
有 发 生 错 误 ， 将 运行 else 代 码 块 ， 并 将 数据 附加 到 相应 列表 的 末尾 ( 见 @ )。 鉴 于 我 们 绘图 时 使 
用 的 是 有 关 男 一 个 地 方 的 信息 ， 我 们 修改 了 标题 ， 在 图 表 中 指出 了 这 个 地 方 ( 见 @ )。 

如 采 你 现在 运行 highs_lows.py， 将 发 现 缺失 数据 的 日 期 只 有 一 个 : 


2014-02-16 missing data 


图 16-6 显 示 了 绘制 出 的 图 形 。 


Daily high and low temperatures - 2014 
120 Death Valley, CA 
100 上 
四 
vw 80r 
3 
各 
vo 
会 60 
民 
40 上 
< 上 N Ny N Ny Ny N Ny N N 
DY ”DY a DY a A 
? 《2 Wo po NM Y Ny MS oe Q AN9 QO2 


图 16-6 ”死亡 谷 每 日 高 气温 和 最 低 气温 


将 这 个 图 表 与 锡 特 卡 的 图 表 对 比 可 知 , 总 体 而 言 , 死亡 谷 比 阿拉 斯 加 东南 部 暖和 ,这 可 能 符 16 
合 预 期 ,但 这 个 沙漠 中 每 天 的 温差 也 更 大 ， 从 着 色 区 域 的 高 度 可 以 明显 看 出 这 一 点 。 

使 用 的 很 多 数据 集 都 可 能 缺失 数据 、 数 据 格式 不 正确 或 数据 本 身 不 正确 。 对 于 这 样 的 情形 ， 

可 使 用 本 书 前 半 部 分 介绍 的 工具 来 处 理 。 在 这 里 , 我 们 使 用 了 一 个 try-except-else 代 码 块 来 处 理 

数据 缺失 的 问题 。 在 有 些 情况 下 ， 需 要 使 用 continue 来 跳 过 一 些 数据 ， 或 者 使 用 remove() 或 del 

将 已 提取 的 数据 删除 。 可 采用 任何 管用 的 方法 ， 只 要 能 进行 精确 而 有 意义 的 可 视 化 就 好 。 
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动手 试 一 斌 
16-1 旧金山 旧金山 的 气温 更 接近 于 锡 特 卡 还 是 死亡 谷 呢 ? 请 绘制 一 个 显示 旧 金 
山 最 高 气温 和 最 低 气 温 的 图 表 , 并 进行 比较 。 可 从 http://www.wunderground.com/history/ 
下 载 几乎 任何 地 方 的 天 气 数据 。 为 此 , 请 输入 相应 的 地 方 和 上 日 期 范围 ,滚动 到 页 面 底部 ， 
找到 名 为 Comma-Delimited File 的 链接 ， 再 单 击 该 链接 ， 将 数据 存储 为 CSV 文件 。 
16-2 比较 锡 特 卡 和 死亡 谷 的 气温 : 在 有 关 锡 特 卡 和 死亡 谷 的 图 表 中 ， 气 温 刻度 反 


映 了 数据 范围 的 不 同 。 为 准确 地 比较 锡 特 卡 和 死亡 谷 的 气温 范围 ， 需 要 在 轴 上 使 用 相 
同 的 刻度 。 为 此 ， 请 修改 图 16-5 和 图 16-6 所 示 图 表 的 轴 设 置 ， 对 饮 特 卡 和 死亡 从 的 
气温 范围 进行 直接 比较 ( 你 也 可 以 对 任何 两 个 地 方 的 气温 范围 进行 比较 )， 你 还 可 以 党 
试 在 一 个 图 表 中 呈现 这 两 个 数据 集 。 
16-3 降雨 量 : 选择 你 感 兴趣 的 任何 地 方 ， 通 过 可 视 化 将 其 降雨 量 呈 现 出 来 。 为 此 ， 
可 先 只 涵盖 一 个 月 的 数据 ， 确 定 代码 正确 无 误 后 ， 再 使 用 一 整 年 的 数据 来 运行 它 。 
16-4 探索 : 生成 一 些 图 表 ， 对 你 好 奇 的 任何 地 方 的 其 他 天 气 数据 进行 研究 。 


16.2 ”制作 世界 人 口 地 图 : JSON 格式 


在 本 节 中 ， 你 将 下 载 JSON 格 式 的 人 口 数 据 ， 并 使 用 json 模 块 来 处 理 它 们 。Pygal 提 供 了 一 个 
适合 初学 者 使 用 的 地 图 创建 工具 , 你 将 使 用 它 来 对 人 口 数据 进行 可 视 化 ,以 探索 全 球 人 口 的 分 布 
情况 。 


16.2.1 下 载 世 弄 人 口 数据 


将 文件 population_data.json 复 制 到 本 音程 序 所 在 的 文件 夹 中 ， 这 个 文件 包含 全 球 大 部 分 国家 
1960~2010 年 的 人 口 数据 。Open Knowledge Foundation ( http://data.okfn.org/ ) 提供 了 大 量 可 以 免 
费 使 用 的 数据 集 ， 这 些 数据 就 来 自 其 中 一 个 数据 集 。 


16.2.2 ”提取 相关 的 数据 
我 们 来 研究 一 下 population data.json， 看 看 如 何 着 手 处 理 这 个 文件 中 的 数据 : 
population_data.json 


[ 
{ 
"Country Name": "Arab World", 
"Country Code": "ARB", 
"Year": "1960", 
"Value": "96388069" 


Whl 
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"Country Name": "Arab World", 
"Country Code": "ARB", 
"Year": "1961", 
"Value": "98882541.4" 

}， 

-- Snip-- 


] 


这 个 文件 实际 上 就 是 一 个 很 长 的 Python 列表 ， 其 中 每 个 元 素 都 是 一 个 包含 四 个 键 的 字典 : 
家 名 、 国 别 码 、 年 份 以 及 表示 人 口 数 量 的 值 。 我 们 只 关心 每 个 国家 2010 年 的 人 口 数量 ， 因 此 我 们 
首先 编写 一 个 打印 这 些 信息 的 程序 : 


world_population.py 


import json 


# 将 数据 加 载 到 一 个 列表 中 
filename = “ population data.json’ 
with open(filename) as f: 

@ pop_data = json.1oad(f) 


# 打印 每 个 国家 2010 年 的 人 口 数量 
@ for pop dict in pop data: 
(3 if pop dict[ "Year'] == '2010": 
@ country name = pop_dict[ "Country Name'] 
population = pop dict['Value'] 
print(country name + ": " + population) 


我 们 首先 导入 了 模块 json， 以 便 能 够 正确 地 加 载 文件 中 的 数据 ， 然 后 ， 我 们 将 数据 存储 在 
pop_data 中 ( 见 @ )。 函 数 json.load() 将 数据 转换 为 Python 能 够 处 理 的 格式 ， 这 里 是 一 个 列表 。 
在 @@ 处 ， 我 们 遍历 pop_data 中 的 每 个 元 素 。 每 个 元 素 都 是 一 个 字典 ， 包 含 四 个 键 - 值 对 ， 我 们 将 
每 个 字典 依次 存储 在 pop_dict 中 。 

在 @ 处 , 我 们 检查 字典 的 'Year' 键 对 应 的 值 是 否 是 2010 ( 由 于 population_datajson 中 的 值 都 是 
用 引号 括 起 的 ， 因 此 我 们 执行 的 是 字符 串 比较 )。 如 果 年 份 为 2010， 我 们 就 将 与 'Country Name' 
相关 联 的 值 存储 到 country_name 中 ,并 将 与 'Value' 相 关联 的 值 存储 在 population 中 ( 见 @ )。 接 下 
来 ,我 们 打印 每 个 国家 的 名 称 和 人 口 数量 。 

输出 为 一 系列 国家 的 名 称 和 人 口 数量 : 

Arab World: 357868000 

Caribbean small states: 6880000 

East Asia & Pacific (all income levels): 2201536674 


-- Snip-- 
Zimbabwe: 12571000 


我 们 捕获 的 数据 并 非 都 包含 准确 的 国家 名 , 但 这 开 了 一 个 好 头 。 现 在 , 我 们 需要 将 数据 转换 
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为 Pygal 能 够 处 理 的 格式 。 
16.2.3 ”将 字符 串 转 换 为 数字 值 


population_data.json 中 的 每 个 键 和 值 都 是 字符 串 。 为 处 理 这 些 人 口 数据 ， 我 们 需要 将 表示 人 
口 数量 的 字符 串 转 换 为 数字 值 ， 为 此 我 们 使 用 函数 int(): 


world_population.py 


-- Snip-- 
for pop dict in pop data: 
if pop dict['Year'] '2010": 
country name = pop dict['Country Name'|] 
© population = int(pop dict['Value']) 
@ print(country name + ": " + str(population)) 


在 @ 人 处 , 我们 将 每 个 人 口 数 量 值 都 存储 为 数字 格式 。 打 印 人 口 数 量 值 时 ， 需要 将 其 转换 为 字 
符 串 ( 见 @ )。 
然而 ， 对 于 有 些 值 ， 这 种 转换 会 导致 错误 ， 如 下 所 示 : 


Arab World: 357868000 
Caribbean small states: 6880000 
East Asia & Pacific (all income levels): 2201536674 
-- Snip-- 
Traceback (most recent call last): 
File "print populations.py", line 12, in <module> 
population = int(pop dict['Value']) 
@ ValueError: invalid literal for int() with base 10: '1127437398.85751 


原始 数据 的 格式 常常 不 统一 ， 因 此 经 常会 出 现 错误 。 导 臻 上 述 错 误 的 原因 是 ，Python 不 能 直 
接 将 包含 小 数 点 的 字符 串 '1127437398.85751 转换 为 整数 〈 这 个 小 数值 可 能 是 人 口 数 据 缺 失 时 通 
过 插值 得 到 的 )。 为 消除 这 种 错误 ， 我 们 先 将 字符 串 转 换 为 浮 点 数 ， 青 将 浮 点 数 转换 为 整数 : 


world_population.py 


=- Ship-- 
for pop dict in pop data: 
if pop dict['Year'] == '2010": 


country = pop dict['Country Name'] 
population = int(float(pop dict[ "Value '])) 
print(country + ": " + str(population)) 


函数 float() 将 字符 囊 转 换 为 小 数 ， 而 函数 int() 丢 弃 小 数 部 分 ， 返回 一 个 整数 。 现 在 ,我 们 
可 以 打印 2010 年 的 完整 人 口 数据 ， 不 会 导致 错误 了 : 


Arab World: 357868000 
Caribbean small states: 6880000 
East Asia & Pacific (all income levels): 2201536674 
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-- Snip-- 
Zimbabwe: 12571000 


每 个 字符 串 都 成 功 地 转换 成 了 浮 点 数 ， 再 转换 为 整数 。 以 数字 格式 存储 人 口 数量 值 后 ,就 可 
以 使 用 它们 来 制作 世界 人 口 地 图 了 。 


16.2.4 获取 两 个 字母 的 国 别 码 


制作 地 图 前 ， 还 需要 解决 数据 存在 的 最 后 一 个 问题 。Pygal 中 的 地 图 制作 工具 要 求 数 据 为 特 
定 的 格式 : 用 国 别 码 表示 国家 ,以 及 用 数字 表示 人 口 数量 。 处 理 地 理 政治 数据 时 ,经 常 需 要 用 到 
几 个 标准 化 国 别 码 集 。population data.json 中 包含 的 是 三 个 字母 的 国 别 码 ， 但 Pygal 使 用 两 个 字母 
的 国 别 码 。 我 们 需要 想 办 法 根据 国家 名 获取 两 个 字母 的 国 别 码 。 

Pygal 使 用 的 国 别 码 存储 在 模块 i18n (internationalization 的 缩写 ) 中 。 字 典 COUNTRIES 包 含 的 
键 和 值 分 别 为 两 个 字母 的 国 别 码 和 国家 名 。 要 查看 这 些 国 别 码 ， 可 从 模块 i18n 中 导入 这 个 字典 ， 
并 打印 其 键 和 值 : 


countries.py 


from pygal.i18n import COUNTRIES 


@ for country code in sorted(COUNTRIES.keys()): 
print(country code, COUNTRIES[country code]) 


在 上 面 的 for 循 环 中 ， 我 们 让 Python 将 键 按 字 母 顺序 排序 ( 见 @ )， 然 后 打印 每 个 国 别 码 及 其 
对 应 的 国家 : 


ad Andorra 

ae United Arab Emirates 
af Afghanistan 

-- Snip-- 

zw Zimbabwe 


为 获取 国 别 码 ， 我 们 将 编写 一 个 函数 ， 它 在 COUNTRIES 中 查找 并 返回 国 别 码 。 我 们 将 这 个 函 
数 放 在 一 个 名 为 country_codes 的 模块 中 ， 以 便 能 够 在 可 视 化 程序 中 导入 它 : 


country_codes.py 


from pygal.i18n import COUNTRIES 


@ def get country code(country name): 
"" "根据 指定 的 国家 ,返回 Pygal 使 用 的 两 个 字母 的 国 别 码 """ 
© for code, name in COUNTRIES.items() 
3 if name == country_ name: 
return code 
# 如 果 没 有 找到 指定 的 国家 ,就 返回 None 
@ return None 
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print(get country_ code('Andorra' ) ) 
print(get country code('United Arab Emirates')) 
print(get country code('Afghanistan' )) 


get_country_code() 接 受 国 家 名 ， 并 将 其 存储 在 形 参 country_name 中 ( 见 @ )。 接 下 来 ,我 们 
裔 历 COUNTRIES 中 的 国家 名 - 国 别 码 对 ( 见 @ ); 如 果 找 到 指定 的 国家 名 ,就 返回 相应 的 国 别 码 ( 见 
@ )。 在 循环 后 面 ， 我 们 在 没有 找到 指定 的 国家 名 时 返回 None ( 见 @ )。 最 后 ， 我 们 使 用 了 三 个 国 
家 名 来 调用 这 个 函数 ， 以 核实 它 能 否 正 确 地 工作 。 与 预期 的 一 样 ， 这 个 程序 输出 了 三 个 由 两 个 字 
母 组 成 的 国 别 码 : 

ad 


ae 
af 


使 用 这 个 函数 前 ， 先 将 country_codes.py 中 的 print 语 句 删 除 。 
接 下 来 ， 在 world_ population.py 中 导入 get _ country_ code: 


world_population.py 


import json 


from country codes import get country code 


-- SNip-- 


# 打印 每 个 国家 2010 年 的 人 口 数量 
for pop dict in pop data: 
if pop dict['Year'] "2010 ' : 
country name = pop dict[' Country Name ] 
population = int(float(pop dict[ "Value'])) 
© code = get country code(country_ name) 
if code: 
print(code + ": "+ str(population)) 
else: 
print('ERROR - ' + Country name) 


©O® 


提取 国家 名 和 人 口 数 量 后 , 我 们 将 国 别 码 存储 在 code 中 , 如 果 没有 国 别 码 , 就 在 其 中 存储 None 
( 见 @ )。 如 果 返 回 了 国 别 码 ， 就 打印 国 别 码 和 相应 国家 的 人 口 数量 ( 见 @ )。 如 果 没 有 找到 国 别 
码 ， 就 显示 一 条 错误 消息 ， 其 中 包含 无 法 找到 国 别 码 的 国家 的 名 称 ( 见 @ )。 如 果 你 运行 这 个 程 
序 ， 将 看 到 一 些 国 别 码 和 相应 国家 的 人 口 数 量 ， 还 有 一 些 错 误 消息 : 


ERROR - Arab World 

ERROR - Caribbean small states 

ERROR - East Asia & Pacific (all income levels) 
-- Snip-- 

af: 34385000 

al: 3205000 

dz: 35468000 

-- Ship-- 
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ERROR - Yemen, Rep. 
zm: 12927000 
ZW: 12571000 


导致 显示 错误 消息 的 原因 有 两 个 。 首先 , 并非 所 有 人 口 数量 对 应 的 都 是 国家 ， 有 些 人 口 数 量 
对 应 的 是 地 区 ( 阿拉伯 世界 ) 和 经 济 类 群 (所 有 收入 水 平 )。 其 次 ， 有 些 统计 数据 使 用 了 不 同 的 
完整 国家 名 ( 如 Yemen, Rep.， 而 不 是 Yemen )。 当 前 ， 我 们 将 忽略 导致 错误 的 数据 ， 看 看 根据 成 
功 恢 复 了 的 数据 制作 出 的 地 图 是 什么 样 的 。 


16.2.5 ”制作 世界 地 图 


有 了 国 别 码 后 , 制作 世界 地 图 易如反掌 。 Pygal 提 供 了 图 表 类 型 Worldmap, 可 帮助 你 制作 呈现 
各 国 数据 的 世界 地 图 。 为 演示 如 何 使 用 Worldmap， 我 们 来 创建 一 个 突出 北美 、 中 美和 南美 的 简单 
地 图 : 


americas.py 


import pygal 


@ wn = pygal.Worldmap() 
wm.title = 'North, Central, and South America' 


四 wn.add('North America', ['ca'’, 'mx', 'us']) 
wm.add('Central America', ['bz', 'cr', 'gt', 'hn', 'ni', 'pa', 'sv']) 
wm.add('South America', ['ar', 'bo', 'br', 'cl', 'co', 'ec', 'gf', 
8y 'pe’, 'py', 'sr', 'uy', 've']) 


四 wn.render to file('americas.svg') 


在 @ 处 , 我们 创建 了 一 个 Worldmap 实 例 ， 并 设置 了 该 地 图 的 的 title 属 性 。 在 @ 处 ,我们 使 用 
了 方法 add()， 它 接受 一 个 标签 和 一 个 列表 ， 其 中 后 者 包含 我 们 要 突出 的 国家 的 国 别 码 。 每 次 调 
用 add() 都 将 为 指定 的 国家 选择 一 种 新 颜色 ， 并 在 图 表 左 边 显示 该 颜色 和 指定 的 标签 。 我 们 要 以 
同一 种 颜色 显示 整个 北美 地 区 ， 因 此 第 一 次 调用 add() 时 ， 在 传递 给 它 的 列表 中 包含 'ca' 、'mx' 
和 'us' ， 以 同时 突出 加 拿 大 、 墨 西 哥 和 美国 。 接 下 来 ， 对 中 美和 南美 国家 做 同样 的 处 理 。 

四 处 的 方法 render to file() 创 建 一 个 包含 该 图 表 的 .svg 文件 , 你 可 以 在 浏览 需 中 打开 它 。 输 
出 是 一 幅 以 不 同 颜色 突出 北美 、 中 美和 南美 的 地 图 ， 如 图 16-7 所 示 。 
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North, Central, and South America - Chromium 
D North, Central, and So x 


$C [D fle///home/ehmatthes/pcc/chapter_16/americas.svg 


North, Central, and South America 


North America 
国 CentraL America 
大 South America 


图 16-7 ”图 表 类 型 Worldmap 的 一 个 简单 实例 


知道 如 何 创建 包含 彩色 区 域 、 颜 色 标示 和 标签 的 地 图 后 , 我 们 在 地 图 中 添加 数据 ， 
关 国 家 的 信息 。 


16.2.6 ”在 世界 地 图 上 呈现 数字 数据 


以 显示 有 


为 练习 在 地 图 上 呈现 数字 数据 ， 我 们 来 创建 一 幅 地 图 ， 显 示 三 个 北美 国家 的 人 口 数 量 : 


na_populations.py 


import pygal 
wm = pygal.Worldmap() 
wm.title = “Populations of Countries in North AmeTica 


@ wm.add('North America', {'ca': 34126000, "us ' : 309349000， "mx' : 113423000}) 


wm.render to file('na populations.svg') 


首先 ， 创 建 了 一 个 Worldmap 实 例 并 设置 了 标题 。 接 下 来 ， 使 用 了 方法 add() ， 但 这 次 通过 第 
二 个 实 参 传递 了 一 个 字典 而 不 是 列表 ( 见 @ )。 这 个 字典 将 两 个 字母 的 Pygal 国 别 码 作为 键 ， 将 人 


口 数量 作为 值 。Pygal 根 据 这 些 数字 自动 给 不 同 国家 着 以 深浅 不 一 的 颜色 ( 人 口 最 少 的 
最 浅 ， 人 口 最 多 的 国家 颜色 最 深 )， 如 图 16-8 所 示 。 


国家 颜色 
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Populations of Countries in North America - Chromium 


D Populations of Count x 


人 © [ file:///home/ehmatthes/pcc/chapter_16/na_populations.svg 


Populations of Countries in North America 


North America 


图 16-8 北美 国家 的 人 口 数量 


这 幅 地 图 具有 交互 性 : 如 果 你 将 鼠标 指向 某 个 国家 , 将 看 到 其 人 口 数 量 。 下 面 在 这 个 地 图 中 
添加 更 多 的 数据 。 


16.2.7 ”绘制 完整 的 世界 人 口 地 图 


要 呈现 其 他 国家 的 人 口 数量 ， 需 要 将 前 面 处 理 的 数据 转换 为 Pygal 要 求 的 字典 格式 : 键 为 两 
个 字母 的 国 别 码 ， 值 为 人 口 数量 。 为 此 ， 在 world_population.py 中 添加 如 下 代码 : 


world_population.py 


import json 


import pygal 


from country codes import get country code 


# 将 数据 加 载 到 列表 中 
-- SNip-- 


# 创建 一 个 包含 人 口 数量 的 字典 
@ cc populations = {} 
for pop dict in pop data: 
if pop dict['Year'] == '2010°': 
country = pop dict['Country Name'] 
population = int(float(pop dict['Value' ])) 
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code = get country code(country) 
if code: 
@ cc populations[code] = population 
@ wm = pygal.Worldmap() 
wm.title = 'World Population in 2010, by CountTy” 
@ wm.add('2010', cc populations) 


wm.render to file('world population.svg') 


我 们 首先 导入 了 pygal。 在 @@ 处 ， 我 们 创建 了 一 个 空 字典 ， 用 于 以 Pygal 要 求 的 格式 存储 国 别 
码 和 人 口 数量 。 在 @ 处 ， 如 果 返 回 了 国 别 码 ， 就 将 国 别 码 和 人 口 数量 分 别 作 为 键 和 值 填 充 字典 
cc_populations。 我 们 还 删除 了 所 有 的 print 语 句 。 

在 人 @ 处 ,我们 创建 了 一 个 Worldmap 实 例 ， 并 设置 其 title 属 性 。 在 @ 处 ,我们 调用 了 add()， 
并 向 它 传递 由 国 别 码 和 人 口 数量 组 成 的 字典 。 图 16-9 显 示 了 生成 的 地 图 。 


Wortd Population in 2010, by Country - chromium 


和 刀口 file///home/ehmatthes/pcc/chapter_16/wortld_population.svg 


World Population in 2010，by Country 


2010 


图 16-9 2010 年 的 世界 人 口 数量 


有 几 个 国家 没有 相关 的 数据 , 我 们 将 其 显示 为 黑色 , 但 对 于 大 多 数 国 家 ,都 根据 其 人 口 数 量 
进行 了 着 色 。 本 音 后 面 将 处 理 数据 缺失 的 问题 ， 这 里 先 来 修改 着 色 ， 以 更 准确 地 反映 各 国 的 人 口 
数量 。 在 当前 的 地 图 中 ,很 多 国家 都 是 浅 色 的 ， 只 有 两 个 国家 是 深 色 的 。 对 大 多 数 国家 而 言 ， 颜 
色 深 浅 的 差别 不 足以 反映 其 人 口 数量 的 差别 ,为 修复 这 种 问题 ,我 们 将 根据 人 口 数 量 将 国家 分 组 ， 
再 分 别 给 每 个 组 着 色 。 
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16.2.8 ”根据 人 口 数 量 将 国家 分 组 


印度 和 中 国 的 人 口 比 其 他 国家 多 得 多 ,但 在 当前 的 地 图 中 ,它们 的 颜色 与 其 他 国家 差别 较 小 。 
中 国 和 印度 的 人 口 都 超过 了 10 亿 ， 接 下 来 人 口 最 多 的 国家 是 美国 ， 但 只 有 大 约 3 亿 。 下 面 不 将 所 
有 国家 都 作为 一 个 编组 , 而 是 根据 人 口 数量 分 成 三 组 一 一 少 于 1000 万 的 、 介 于 1000 万 和 10 亿 之 间 
的 以 及 超过 10 亿 的 : 


world_population.py 


-- Snip-- 
# 创建 一 个 包含 人 口 数据 的 字典 
cc populations = {} 
for pop dict in pop data: 
if pop dict['Year'] == '2010": 
--SNnip-- 
if code: 
cc populations[code] = population 


# 根据 人 口 数量 将 所 有 的 国家 分 成 三 组 
@ cc pops 1, cc pops 2, cc pops 3 = {}, {}, {} 
@ for cc, pop in cc populations.items(): 
if pop < 10000000: 
cc pops 1[cc] = pop 
elif pop < 1000000000: 
cc pops 2[cc] = pop 
else: 
cc pops 3[cc] = pop 


# 看 看 每 组 分 别 包 含 多 少 个 国家 
@ print(len(cc pops 1), len(cc pops 2), len(cc pops 3)) 


wm = pygal.Worldmap() 

wm.title = "World Population in 2010, by Country' 
@ wm.add('0-10m', cc pops 1) 

wm.add('10om-1bn', cc pops 2) 

wm.add('>1ibn', cc pops 3) 


wm.render to file('world population.svg ) 


为 将 国家 分 组 ,我 们 创建 了 三 个 空 字典 ( 见 @ )。 接 下 来 , 遍历 cc_populations，, 检查 每 个 国 
家 的 人 口 数量 ( 见 @ )。if-elif-else 代 码 块 将 每 个 国 别 码 - 人 口 数量 对 加 入 到 合适 的 字典 
(cc_pops 1、cc pops 2 或 cc_pops 3 ) 中 。 

在 @ 处 ,我 们 打印 这 些 字典 的 长 度 ， 以 获悉 每 个 分 组 的 规模 。 绘制 地 图 时 ,我 们 将 全 部 三 个 
分 组 都 添加 到 Worldmap 中 ( 见 @ )。 如 果 你 现在 运行 这 个 程序 ， 首 先 看 到 的 将 是 每 个 分 组 的 规模 : 


85 69 2 


上 述 输出 表明 ， 人 口 少 于 1000 万 的 国家 有 85 个 ， 人 口 介 于 1000 万 和 10 亿 之 间 的 国家 有 69 个 ， 
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还 有 两 个 国家 比较 特殊 ， 其 人 口 都 超过 了 10 亿 。 这 样 的 分 组 看 起 来 足够 了 ,让 地 图 包含 丰富 的 信 
息 。 图 16-10 显 示 了 生成 的 地 图 。 


World Population in 2010, by Country - chromium 


和 © DD file:///home/ehmatthes/pcc/chapter_16/world_population.svg 


World Population in 2010, by Country 


图 16-10 分 三 组 显示 的 世界 各 国人 口 


现在 使 用 了 三 种 不 同 的 颜色 ， 让 我 们 能 够 看 出 人 口 数 量 上 的 差别 。 在 每 组 中 ,各 个 国家 都 按 
人 口 从 少 到 多 着 以 从 浅 到 深 的 颜色 。 


16.2.9 使 用 Pygal 设置 世界 地 图 的 样式 


在 这 个 地 图 中 , 根据 人 口 将 国家 分 组 虽然 很 有 效 , 但 默认 的 颜色 设置 很 难看 。 例如 , 在 这 里 ， 
Pygal 选 择 了 鲜艳 的 粉色 和 绿色 基色 。 下 面 使 用 Pygal 样 式 设置 指令 来 调整 颜色 。 
我 们 也 让 Pygal 使 用 一 种 基色 ， 但 将 指定 该 基色 ， 并 让 三 个 分 组 的 颜色 差别 更 大 : 


world_population.py 


import json 


import pygal 
@ from pygal.style import RotateStyle 
-- SNip-- 
# 根据 人 口 数量 将 所 有 的 国家 分 成 三 组 
cc pops 1, cc pops 2, cc pops 3 = {}, {}, {} 
for cc, pop in cc populations.items(): 
if pop < 10000000: 
-- SNip-- 
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@ wm style = RotateStyle('#336699') 
@ wm = pygal.Worldmap(style=wm style) 
wm.title = 'World Population in 2010, by Country’ 


-- Ship-- 


Pygal 样 式 存储 在 模块 style 中 ， 我 们 从 这 个 模块 中 导 和 人 了 样式 RotateSstyle ( 见 @ )。 创建 这 
个 类 的 实例 时 ， 需 要 提供 一 个 实 参 一 一 十 六 进 制 的 RGB 颜 色 ( 见 @ ); Pygal 将 根据 指定 的 颜色 为 
每 组 选择 颜色 。 十 六 进 制 格式 的 RGB 颜 色 是 一 个 以 井 号 (#) 打头 的 字符 串 ， 后 面 跟着 6 个 字符 ， 
其 中 前 两 个 字符 表示 红色 分 量 , 接 下 来 的 两 个 表示 绿色 分 量 , 最 后 两 个 表示 蓝 色 分 量 。 每 个 分 量 
的 取 值 范围 为 00( 没有 相应 的 颜色 )~FF( 包含 最 多 的 相应 颜色 )。 如 果 你 在 线 搜索 hex color chooser 
(十 六 进 制 颜色 选择 器 ), 可 找到 让 你 能 够 尝试 选择 不 同 的 颜色 并 显示 其 RGB 值 的 工具 。 这 里 使 用 
的 颜色 值 (#336699 ) 混合 了 少量 的 红色 ( 33 )、 多 一 些 的 绿色 ( 66 ) 和 更 多 一 些 的 蓝 色 (99 )， 
它 为 RotateStyle 提 供 了 一 种 淡 蓝 色 基 色 。 

Rotatestyle 返 回 一 个 样式 对 象 , 我 们 将 其 存储 在 wm_style 中 。 为 使 用 这 个 样式 对 象 , 我 们 在 
创建 Worldmap 实 例 时 以 关键 字 实 参 的 方式 传递 它 ( 见 @ )。 更 新 后 的 地 图 如 图 16-11 所 示 。 


- World Populationin 2 x 


国 9-19m 
国 10m-1lbn 
国 >lbn 


名 © BD file:///home/ehmatthes/pcc/chapter_16/world_population.svg 


World Population in 2010, by Country 


图 16-11 


按 人 


口 划分 的 三 个 国家 编组 了 统一 的 颜色 主题 


前 面 的 样式 设置 让 地 图 的 颜色 更 一 致 ， 也 更 容易 区 分 不 同 的 编组 。 


16.2.10 ”加 亮 颜色 主题 


Pygal 通 常 默认 使 用 较 暗 的 颜色 主题 。 为 方便 印刷 ， 我 使 用 LightColorizedstyle 加 亮 了 地 图 
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的 颜色 。 这 个 类 修改 整个 图 表 的 主题 , 包括 背景 色 、 标签 以 及 各 个 国家 的 颜色 。 要 使 用 这 个 样式 ， 
先导 入 它 : 


from pygal.style import LightColorizedStyle 


然后 就 可 独立 地 使 用 LightColorizedSstyle 了 ， 例 如 ; 


wm_style = LightColorizedStyle 


然而 使 用 这 个 类 时 ， 你 不 能 直接 控制 使 用 的 颜色 ，Pygal 将 选择 默认 的 基色 。 要 设置 颜色 ， 
可 使 用 Rotatestyle， 并 将 LightColorizedstyle 作 为 基本 样式 。 为 此 ， 导 入 LightColorizedstyle 
和 Rotatestyle: 


from pygal.style import LightColorizedStyle, RotateStyle 


青 使 用 Rotatestyle 创 建 一 种 样式 ， 并 传人 另 一 个 实 参 base_style: 


WI 


style = RotateStyle('#336699', base style=LightColorizedSstyle) 


这 设置 了 较 亮 的 主题 , 同时 根据 通过 实 参 传递 的 颜色 给 各 个 国家 着 色 。 使 用 这 种 样式 时 ， 生 
成 的 图 表 与 本 书 的 屏幕 截图 更 一 致 。 
尝试 为 不 同 的 可 视 化 选择 合适 的 样式 设置 指令 时 ， 在 import 语 句 中 指定 别名 会 有 所 帮助 : 


from pygal.style import LightColorizedStyle as LCS, RotateStyle as RS 


这 样 ， 样 式 定义 将 更 短 : 


wm_styjle = RS('#336699', base style=LCS) 


通过 使 用 儿 个 样式 设置 指令 ， 就 能 很 好 地 控制 图 表 和 地 图 的 外 观 。 


动手 试 一 斌 


16-5 涵盖 所 有 国家 : 本 节制 作 人 口 地 图 时 ， 对 于 大 约 12 个 国家 ， 程 序 不 能 自动 确 
定 其 两 个 字母 的 国 别 码 。 请 找 出 这 些 国家 ， 在 字典 COUNTRIES 中 找到 它们 的 国 别 码 ; 然 
后 ， 对 于 每 个 这 样 的 国家 ， 都 在 get country code() 中 添加 一 个 if-elif 代码 块 ， 以 返 


回 其 国 别 码 : 


if country name == “Yemen，Rep.' 


return “ye 


elif --snip-- 


将 这 些 代 码 放 在 遍历 COUNTRIES 的 循环 和 语句 return None 之 间 。 完 成 这 样 的 修改 
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后 ， 你 看 到 的 地 图 将 更 完整 。 

16-6 国内 生产 总 值 : Open Knowledge Foundation 提供 了 一 个 数据 集 ， 其 中 包含 全 
球 各 国 的 国内 生产 总 值 ( GDP ), 可 在 http://data.okfn.org/data/core/gdp/ 找 到 这 个 数据 集 。 
请 下 载 这 个 数据 集 的 JSON 版 本 ， 并 绘制 一 个 图 表 ， 将 全 球 各 国 最 近 一 年 的 GDP 呈现 
强加- 

16-7 选择 你 自己 的 数据 : 世界 银行 (The World Bank ) 提供 了 很 多 数据 集 ， 其 中 包 
含有 关 全 球 各 国 的 信息 。 请 访问 http://data.worldbank.org/indicator/， 并 找到 一 个 你 感 兴 
趣 的 数据 集 。 单 击 该 数据 集 ， 再 单 击 链 接 Download Data 并 选择 CSV。 你 将 收 到 三 个 
CSV 文件 ， 其 中 两 个 包含 字样 Metadata， 你 应 使 用 第 三 个 CSV 文件 。 编 写 一 个 程序 ， 
生成 一 个 字典 ， 它 将 两 个 字母 的 Pygal 国 别 码 作为 键 ， 并 将 你 从 这 个 文件 中 选择 的 数据 
作为 值 。 使 用 Worldmap 制作 一 个 地 图 ， 在 其 中 呈现 这 些 数据 ， 并 根据 你 的 喜好 设置 这 
个 地 图 的 样式 。 

16-8 测试 模块 country_codes: 我 们 编写 模块 country _ codes 时 ， 使 用 了 print 语 
多 来 核实 get_country_code() 能 否 按 预期 那样 工作 。 请 利用 你 在 第 11 章 学 到 的 知识 ， 
为 这 个 函数 编写 合适 的 测试 。 
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在 本 章 中 ， 你 学 习 了 : 如 何 使 用 网 上 的 数据 集 ; 如 何 处 理 CSV 和 JSON 文 件 ， 以 及 如 何 提 取 
你 感 兴趣 的 数据 ; 如 何 使 用 matplotlib 来 处 理 以 往 的 天 气 数据 ,包括 如 何 使 用 模块 datetime， 以 及 
如 何在 同一 个 图 表 中 绘制 多 个 数据 系列 ;如 何 使 用 Pygal 绘 制 呈现 各 国 数据 的 世界 地 图 ， 以 及 如 
何 设置 Pygal 地 图 和 图 表 的 样式 。 

有 了 使 用 CSV 和 JSON 文 件 的 经 验 后 ， 你 将 能 够 处 理 几 乎 任何 要 分 析 的 数据 。 大 多 数 在 线 数 
据 集 都 可 以 以 这 两 种 格式 中 的 一 种 或 两 种 下 载 。 学习 使 用 这 两 种 格式 为 学 习 使 用 其 他 格式 的 数据 
做 好 了 准备 。 

在 下 一 章 , 你 将 编写 自动 从 网 上 采集 数据 并 对 其 进行 可 视 化 的 程序 。 如 果 你 只 是 将 编程 作为 
业余 爱好 ， 学 会 这 些 技能 可 以 增加 乐趣 ; 如 果 你 有 志 于 成 为 专业 程序 员 ， 就 必须 掌握 这 些 技能 。 


使 用 API 


在 本 章 中 , 你 将 学 习 如 何 编 写 一 个 独立 的 程序 , 并 对 其 获取 的 数 
据 进 行 可 视 化 。 这 个 程序 将 使 用 Web 应 用 编程 接口 (API ) 自动 请 求 
网 站 的 特定 信息 而 不 是 整个 网 页 ， 再 对 这 些 信 息 进行 可 视 化 。 由 于 这 
样 编写 的 程序 始终 使 用 最 新 的 数据 来 生成 可 视 化 ,因此 即便 数据 瞬息 
万 变 ， 它 呈现 的 信息 也 都 是 最 新 的 。 


17.1 使 用 Web API 


Web API 是 网 站 的 一 部 分 ， 用 于 与 使 用 非常 具体 的 URL 请 求 特 定 信息 的 程序 交互 。 这 种 请 求 
称 为 API 调 用 。 请 求 的 数据 将 以 易于 处 理 的 格式 ( 如 JSON 或 CSV ) 返回 。 依赖 于 外 部 数据 源 的 大 
多 数 应 用 程序 都 依赖 于 API 调 用 ， 如 集成 社交 媒体 网 站 的 应 用 程序 。 


17.1.1 Git 和 GitHub 


本 章 的 可 视 化 将 基于 来 自 GitHub 的 信息 , 这 是 一 个 让 程序 员 能 够 协作 开发 项 目的 网 站 。 我 们 
将 使 用 GitHub 的 API 来 请 求 有 关 该 网 站 中 Python 项 目的 信息 ， 然 后 使 用 Pygal 生 成 交互 式 可 视 化 ， 
以 呈现 这 些 项 目的 受 欢迎 程度 。 

GitHub ( https://github.com/ ) 的 名 字源 自 Git，Git 是 一 个 分 布 式 版 本 控制 系统 ， 让 程序 员 团 队 能 
够 协作 开发 项 目 。Git 帮 助 大 家 管理 为 项 目 所 做 的 工作 ， 避 免 一 个 人 所 做 的 修改 影响 其 他 人 所 做 的 
修改 。 你 在 项 目 中 实现 新 功能 时 ，Git 将 跟踪 你 对 每 个 文件 所 做 的 修改 。 确 定 代 码 可 行 后 ， 你 提交 
所 做 的 修改 ， 而 Git 将 记录 项 目 最 新 的 状态 。 如 果 你 犯 了 错 ， 想 撤销 所 做 的 修改 ， 可 轻松 地 返回 以 
前 的 任何 可 行 状态 ( 要 更 深入 地 了 解 如 何 使 用 Git 进 行 版 本 控制 ， 请 参阅 附录 D )。GitHub 上 的 项 目 
都 存储 在 仓库 中 ， 后 者 包含 与 项 目 相 关联 的 一 切 : 代码 、 项 目 参 与 者 的 信息 、 问 题 或 bug 报 告 等 。 

对 于 喜欢 的 项 目 ，GitHub 用 户 可 给 它 加 星 (star ) 以 表示 支持 ， 用 户 还 可 跟踪 他 可 能 想 使 用 
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的 项 目 。 在 本 章 中 ， 我 们 将 编写 一 个 程序 ， 它 自动 下 载 GitHub 上 星 级 最 高 的 Python 项 目的 信息 ， 
并 对 这 些 信 息 进 行 可 视 化 。 
17.1.2 ”使 用 API 调用 请 求 数据 


GitHub 的 API 让 你 能 够 通过 API 调 用 来 请 求 各 种 信息 。 要 知道 API 调 用 是 什么 样 的 ， 请 在 浏览 
器 的 地 址 栏 中 输入 如 下 地 址 并 按 回 车 键 : 


https://api.github.com/search/repositories?q=language:python&sort=stars 


这 个 调用 返回 GitHub 当 前 托管 了 多 少 个 Python 项 目 , 还 有 有 关 最 受 欢 迎 的 Python 仓 库 的 信息 。 
下 面 来 仔细 研究 这 个 调用 。 第 一 部 分 (https://api.github.com/ ) 将 请 求 发 送 到 GitHub 网 站 中 响 
应 API 调 用 的 部 分 ; 接 下 来 的 一 部 分 ( search/repositories ) 让 API 搜 索 GitHub 上 的 所 有 仓库 。 

repositories 后 面 的 问号 指出 我 们 要 传递 一 个 实 参 。q 表 示 查 询 , 而 等 号 让 我 们 能 够 开始 指定 
查询 ( q= )。 通 过 使 用 language:python， 我 们 指出 只 想 获 取 主 要 语言 为 Python 的 仓库 的 信息 。 最 
后 一 部 分 (8sort=stars ) 指定 将 项 目 按 其 获得 的 星 级 进行 排序 。 

下 面 显示 了 响应 的 前 儿 行 。 从 响应 可 知 ， 该 URL 并 不 适合 人 工 输入 。 


"total count": 713062， 
"incomplete results": false, 
"items": [ 
{ 
"id": 3544424， 
"name": "httpie", 
"full name": "jkbrzt/httpie", 
-- Snip-- 


从 第 二 行 输出 可 知 , 编写 本 书 时 , GitHub 总 共有 713 062 个 Python 项 目 。 "incomplete results" 
的 值 为 false， 据 此 我 们 知道 请 求 是 成 功 的 ( 它 并 非 不 完整 的 )。 倘 若 GitHub 无 法 全 面 处 理 该 APL， 
它 返 回 的 这 个 值 将 为 true。 接 下 来 的 列表 中 显示 了 返回 的 "items" ， 其 中 包含 GitHub 上 最 受 欢 迎 
的 Python 项 目的 详细 信息 。 


17.1.3 ”安装 requests 


requests 包 让 Python 程序 能 够 轻松 地 向 网 站 请 求 信 , 息 以 及 检查 返回 的 响应 。 要 安装 requests ， 
请 执行 类 似 于 下 面 的 命令 : 


$ pip install --user requests 


如 果 你 还 没有 使 用 过 pip， 请 参阅 12.2.1 节 (根据 系统 的 设置 ， 你 可 能 需要 使 用 这 个 命令 的 稍 
微 不 同 的 版 本 )。 
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17.1.4 “处理 API 响应 


下 面 来 编写 一 个 程序 ， 它 执行 API 调 用 并 处 理 结果 ， 找 出 GitHub 上 星 级 最 高 的 Python 项 目 : 
python_repos.py 


@ import requests 


# 执行 API 调 用 并 存储 响应 
@ url = 'https://api.github.com/search/repositories?q=language:python&sort=stars 
@ r = requests.get(url) 
@ print("Status code:", r.status code) 


# 将 API 响 应 存储 在 一 个 变量 中 


©@ response dict = r.json() 


# 处 理 结果 

print(response dict.keys()) 

在 @ 人 处 ,我 们 导入 了 模块 requests。 在 @ 处 ,我 们 存储 API 调 用 的 URL， 然 后 使 用 requests 
来 执行 调用 ( 见 @ )。 我 们 调用 get() 并 将 URL 传 递 给 它 ， 再 将 响应 对 象 存储 在 变量 中。 响应 对 
象 包含 一 个 名 为 status_code 的 属性 ， 它 让 我 们 知道 请 求 是 否 成 功 了 ( 状态 码 200 表 示 请 求 成 功 )。 
在 @ 处 ,我 们 打印 status_code， 核 实 调用 是 否 成 功 了 。 

这 个 API 返 回 JSON 格 式 的 信息 ， 因 此 我 们 使 用 方法 json() 将 这 些 信 息 转换 为 一 个 Python 字典 
( 见 @ )。 我 们 将 转换 得 到 的 字典 存储 在 response_dict 中 。 

最 后 ， 我 们 打印 response_dict 中 的 键 。 输 出 如 下 : 


Status code: 200 
dict keys(['items', 'total count', 'incomplete results']) 


状态 码 为 200， 因 此 我 们 知道 请 求 成 功 了 。 响 应 字典 只 包含 三 个 键 : 'items' 、'total_count' 


和 'incomplete results'。 


注意 像 这 样 简单 的 调用 应 该 会 返回 完整 的 结果 集 , 因此 完全 可 以 忽略 与 'incomplete results' 
相关 联 的 值 。 但 执行 更 复杂 的 API 调 用 时 ， 程 序 应 检查 这 个 值 。 


17.1.5 “处 理 响 应 字典 


将 API 调 用 返回 的 信息 存储 到 字典 中 后 ， 就 可 以 处 理 这 个 字典 中 的 数据 了 。 下 面 来 生成 一 些 
概述 这 些 信息 的 输出 。 这 是 一 种 不 错 的 方式 ,可 确认 收 到 了 期 望 的 信息 ,进而 可 以 开始 研究 感 兴 
趣 的 信息 : 


python_repos.py 


import requests 
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# 执行 API 调 用 并 存储 响应 

url = 'https://api.github.com/search/repositories?q=language:python&sort=stars' 
r = requests.get(ur]) 

print("Status code:", r.status code) 


# 将 API 响 应 存储 在 一 个 变量 中 
response dict = r.json() 
@ print("Total repositories:", response dict['total count']) 


# 探索 有 关 仓 库 的 信息 
@ repo dicts = response dict['items'] 
print("Repositories returned:", len(repo dicts)) 


# 研究 第 一 个 仓库 


@ repo dict = repo dicts[0] 
@ print("\nKeys:", len(repo dict)) 
© for key in sorted(repo dict.keys()): 
print(key) 
在 @ 处 , 我 们 打印 了 与 'total_count' 相 关联 的 值 , 它 指出 了 GitHub 总 共 包 含 多 少 个 Python 仓 
库 。 


与 'items' 相 关联 的 值 是 一 个 列表 ， 其 中 包含 很 多 字典 ， 而 每 个 字典 都 包含 有 关 一 个 Python 
仓库 的 信息 。 在 @ 人 处 ， 我 们 将 这 个 字典 列表 存储 在 repo_dicts 中 。 接 下 来 ,我 们 打印 repo_dicts 
的 长 度 ， 以 获悉 我 们 获得 了 多 少 个 仓库 的 信息 。 

为 更 深入 地 了 人 解 返回 的 有 关 每 个 仓库 的 信息 ， 我 们 提取 了 repo_dicts 中 的 第 一 个 字典 ， 并 将 
其 存储 在 repo_dict 中 ( 见 @ ), 接 下 来 , 我 们 打印 这 个 字典 包含 的 键 数 , 看 看 其 中 有 多 少 信息 ( 见 
@ )。 在 @ 处 ， 我 们 打印 这 个 字典 的 所 有 键 ， 看 看 其 中 包含 哪些 信息 。 

输出 让 我 们 对 实际 包含 的 数据 有 了 更 清晰 的 认识 : 


Status code: 200 
Total repositories: 713062 
Repositories returned: 30 


@ Keys: 68 
archive url 
assignees url 
blobs url 
-- Snip-- 
url 
watchers 
watchers count 


GitHub 的 API 返 回 有 关 每 个 仓库 的 大 量 信息 : repo_dict 包 含 68 个 键 ( 见 @ )。 通 过 仔细 查看 
这 些 键 ,可 大 致知 道 可 提取 有 关 项 目的 哪些 信息 0 返回 哪些 信息 ， 要 么 阅读 
文档 ， 要 么 像 此 处 这 样 使 用 代码 来 查看 这 些 信息 

下 面 来 提取 repo_dict 中 与 一 些 键 相 关联 的 : 
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python_repos.py 


-- Snip-- 

# 研究 有 关 仓 麻 的 信息 

repo dicts = response dict['items'] 
print("Repositories returned:", len(repo dicts)) 


# 研究 第 一 个 仓库 


repo dict = repo dicts[0] 
print("\nSelected information about first repository:") 
@ print('Name:', repo dict['name']) 
@ print('Owner:', repo dict['owner']['login']) 
@ print('Stars:', repo dict['stargazers count']) 
print('Repository:', repo dict['html url']) 
@ print('Created:', repo dict['created at']) 
©@ print('Updated:', repo dict['updated at']) 
print('Description:', repo dict['description']) 


在 这 里 ,我 们 打印 了 表示 第 一 个 仓库 的 字典 中 与 很 多 键 相 关联 的 值 。 在 @ 处 ,我 们 打印 了 项 
目的 名 称 。 项 目 所 有 者 是 用 一 个 字典 表示 的 ， 因 此 在 @@ 处 ， 我 们 使 用 键 owner 来 访问 表示 所 有 者 
的 字典 ， 再 使 用 键 key 来 获取 所 有 者 的 登录 名 。 在 上 处 ， 我 们 打印 项 目 获得 了 多 少 个 星 的 评级 ， 
以 及 项 目 在 GitHub 仓 库 的 URL。 接 下 来 ,我 们 显示 项 目的 创建 时 间 ( 见 @ ) 和 最 后 一 次 更 新 的 时 


间 ( 见 @ )。 最 后 ， 我 们 打印 仓库 的 描述 。 输 出 类 似 于 下 面 这样 : 


Status code: 200 
Total repositories: 713065 
Repositories returned: 30 


Selected information about first repository: 
Name: httpie 
Owner: jkbrzt 
Stars: 1610 
Repository: https://github.com/jkbrzt/httpie 
Created: 2012-02-25T12:39:132 

Updated: 2015-07-13T14:56:41Z 


Description: CLI HTTP client; user-friendly cURL replacement featuring intuitive UI, JSON support, 


syntax highlighting, wget-like downloads, extensions, etc. 


从 上 上 述 输出 可 知 ， 编 写本 书 时 ，GitHub 上 星 级 最 高 的 Python 项 目 为 HTTPie， 其 所 有 者 为 月 


有 户 


jkbrzt， 有 16 000 多 个 GitHub 用 户 给 这 个 项 目 加 星 。 我 们 可 以 看 到 这 个 项 目的 仓库 的 URL， 其 创建 
时 间 为 2012 年 2 月 ， 旦 最 近 更 新 了 。 最 后 ， 描 述 指出 HTTPie 用 于 帮助 从 终端 执行 HTTP 调 用 ( CLI 


是 命令 行 界面 的 缩写 )。 


17.1.6 ”概述 最 受 欢迎 的 仓库 


对 这 些 数 据 进行 可 视 化 时 ， 我 们 需要 涵盖 多 个 仓库 。 下 面 就 来 编写 一 个 循环 ， 打 印 API 调 用 


返回 的 每 个 仓库 的 特定 信息 ， 以 便 能 够 在 可 视 化 中 包含 所 有 这 些 信 息 : 
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python_repos.py 


-- SNip-- 

# 研究 有 关 仓 库 的 信息 

repo dicts = response dict['items'] 
print("Repositories returned:", len(repo dicts)) 


@ print("\nSelected information about each repository:") 
@ for repo dict in repo dicts: 
print('\nName:', repo dict['name' ]) 
print('Owner:', repo dict['owner']['login']) 
print('Stars:', repo dict['stargazers count']) 
print('Repository:', repo dict['html url']) 
print('Description:', repo dict['description']) 


在 @ 处 ,我们 打印 了 一 条 说 明 性 消息 。 在 @ 处 ,我 们 遍历 repo_dicts 中 的 所 有 字典 。 在 这 个 
循环 中 ,我 们 打印 每 个 项 目的 名 称 、 所 有 者 、 星 级 、 在 GitHub 上 的 URL 以 及 描述 : 


Status code: 200 
Total repositories: 713067 
Repositories returned: 30 


Selected information about each repository: 


Name: httpie 

Owner: jkbrzt 

Stars: 16101 

Repository: https://github.com/jkbrzt/httpie 

Description: CLI HTTP client; user-friendly cURL replacement featuring intuitive UI, JSON support, 
syntax highlighting, wget-like downloads, extensions, etc. 


Name: django 

Owner: django 

Stars: 15028 

Repository: https://github.com/django/django 

Description: The Web framework for perfectionists with deadlines. 
-- Snip-- 


ame: powerline 
Owner: powerline 
Stars: 4315 
Repository: https://github.com/powerline/powerline 

Description: Powerline is a statusline plugin for vim, and provides statuslines and prompts for several 
other applications, including zsh, bash, tmux, IPython, Awesome and Qtile. 


上 述 输出 中 有 一 些 有 趣 的 项 目 ， 可 能 值得 青 看 一 眼 。 但 不 要 在 这 上 面 花费 太 多 时 间 ， 因 为 我 
们 即将 创建 的 可 视 化 可 让 你 更 容易 地 看 清 结果 。 


17.1.7 ”监视 API 的 速率 限制 
大 多 数 API 都 存在 速率 限制 ， 即 你 在 特定 时 间 内 可 执行 的 请 求 数 存在 限制 。 要 获悉 你 是 否 接近 
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了 GitHub 的 限制 ， 请 在 浏览 器 中 输入 https://api.github.conyrate_limit， 你 将 看 到 类 似 于 下 面 的 响应 : 


{ 
"resources": 1{ 
"core": { 
"limit": 60， 
"remaining": 58, 
"reset": 1426082320 
和 
© "search": { 
[29 imi O08 
上 "remaining": 8， 
@ "reset": 1426078803 
入 
"rate": { 
imit :60; 
"remaining": 58， 
"reset": 1426082320 
} 
} 


我 们 关心 的 信息 是 搜索 API 的 速率 限制 ( 见 @ )。 从 @ 人 处 可 知 ,极限 为 每 分 钟 10 个 请 求 ， 而 在 
当前 这 一 分 钟 内 ， 我 们 还 可 执行 8 个 请 求 ( 见 @ )。reset 值 指 的 是 配额 将 重 置 的 Unix 时 间或 新 纪 
元 时 间 (1970 年 1 月 1 日 午夜 后 多 少 秒 ) ( 见 @ )。 用 完 配 额 后 ,你 将 收 到 一 条 简单 的 响应 ， 由 此 知 
道 已 到 达 API 极 限 。 到 达 极 限 后 ， 你 必须 等 待 配额 重 置 。 


注意 很 多 API 都 要 求 你 注册 获得 API 密 钥 后 才能 执行 API 调 用 。 编 写本 书 时 ，GitHub 没 有 这 样 
的 要 求 ， 但 获得 API 密 钥 后 ， 配 额 将 高 得 多 。 


17.2 ”使 用 Pygal 可 视 化 仓库 


有 了 一 些 有 趣 的 数据 后 ， 我 们 来 进行 可 视 化 ， 呈 现 GitHub 上 Python 项 目的 受 欢 迎 程度 。 我 们 
将 创建 一 个 交互 式 条 形 图 : 条 形 的 高 度 表 示 项 目 获得 了 多 少 颗 星 。 单 击 条 形 将 带 你 进入 项 目 在 
GitHub 上 的 主页 。 下 面 是 首次 尝试 这 样 做 : 


python_repos.py 


import requests 
import pygal 
from pygal.style import LightColorizedStyle as LCS, LightenStyle as LS 


# 执行 API 调 用 并 存储 响应 

URL = "https://api.github.com/search/repositories?q=language:python&sort=star' 
r = requests.get(URL) 

print("Status code:", r.status code) 
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# 将 API 响 应 存储 在 一 个 变量 中 
response dict = r.json() 
print("Total repositories:", response dict['total count']) 


# 研究 有 关 仓 库 的 信息 
repo dicts = response dict['items'] 


@ names, stars = [], [|] 
for repo dict in repo dicts: 
(2 names.append(repo dict[ 'name']) 
stars.append(repo dict['stargazers count']) 


# 可 视 化 
@ my style = LS('#333366', base style=LCS) 
@ chart = pygal.Bar(style=my_style, x label rotation=45, show legend=False) 
chart.title = 'Most-Starred Python Projects on GitHub' 
chart.x labels = names 


©@ chart.add('', stars) 
chart.render to file('python repos.svg') 


我 们 首先 导入 了 pygal 以 及 要 应 用 于 图 表 的 Pygal 样 式 。 接 下 来 ， 打 印 API 调 用 响应 的 状态 以 
及 找到 的 仓库 总 数 ， 以 便 获 悉 API 调 用 是 否 出 现 了 问题 。 我 们 不 再 打印 返回 的 有 关 项 目的 信息 ， 
为 将 通过 可 视 化 来 呈现 这 些 信息 。 

在 @ 处 , 我们 创建 了 两 个 空 列表 ， 用 于 存储 将 包含 在 图 表 中 的 信息 。 我 们 需要 每 个 项 目的 名 
称 , 用 于 给 条 形 加 上 标签 ,我 们 还 需要 知道 项 目 获 得 了 多 少 个 星 ， 用 于 确定 条 形 的 高 度 。 在 循环 
中 ， 我 们 将 项 目的 名 称 和 获得 的 星 数 附 加 到 这 些 列 表 的 末尾 @。 

接 下 来 , 我 们 使 用 Lightenstyle 类 ( 别名 LS ) 定义 了 一 种 样式 , 并 将 其 基色 设置 为 深蓝 色 ( 见 
@ )。 我 们 还 传递 了 实 参 base_style， 以 使 用 LightColorizedStyle 类 ( 别名 LCS )。 然后 ,我 们 使 用 
Bar() 创 建 一 个 简单 的 条 形 图 , 并 向 它 传递 了 my_style ( 见 @ ), 我们 还 传递 了 另外 两 个 样式 实 参 : 
让 标签 绕 x 轴 旋转 45 度 ( x_label_rotation=45 )， 并 隐藏 了 图 例 (show_legend=False )， 因 为 我 们 
只 在 图 表 中 绘制 一 个 数据 系列 。 接 下 来 ,我 们 给 图 表 指 定 了 标题 ， 并 将 属性 x_labels 设 置 为 列表 
names。 

由 于 我 们 不 需要 给 这 个 数据 系列 添加 标签 ,因此 在 @@ 处 添加 数据 时 , 将 标签 设置 成 了 空 字 符 
串 。 生 成 的 图 表 如 图 17-1 所 示 。 从 中 可 知 ， 前 几 个 项 目的 受 欢 迎 程 度 比 其 他 项 目 高 得 多 , 但 所 有 
这 些 项 目 在 Python 生 态 系 统 中 都 很 重要 。 
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图 17-1 GitHub 上 受 


17.2.1 改进 Pygal 图 表 
下 面 来 改进 这 个 图 表 的 样式 。 我 们 将 进 4 


python_repos.py 


欢迎 程度 最 


了 多 个 方面 的 定制 ， 
创建 一 个 配置 对 象 ， 在 其 中 包含 要 传递 给 Bar() 的 所 有 定 


高 的 Python 项 目 


此 先 来 稍微 调整 代码 的 结构 ， 


制 : 


-- Snip-- 
# 可 视 化 
my_style = LS('#333366', base style=LCS) 

@ my config = pygal.Config() 

@ my config.x label rotation = 45 
my_config.show legend = False 

@ my config.title font size = 24 
my_config.label font size = 14 
my_config.major label font size = 18 

@ my config.truncate label = 

© my config.show y guides = False 

@ my config.width = 1000 

@ chart = pygal.Bar(my config, style=my style) 
chart.title = 'Most-Starred Python Projects on GitHub" 


chart.x labels = names 


chart.add('', stars) 
chart.render to file('python repos.svg') 
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在 @ 处 , 我 们 创建 了 一 个 Pygal 类 config 的 实例 , 并 将 其 命名 为 my_config。 通过 修改 my_config 
的 属性 , 可 定制 图 表 的 外 观 。 在 @ 处 , 我 们 设置 了 两 个 属性 一 x label rotation 和 show legend， 
它们 原来 是 在 创建 Bar 实 例 时 以 关键 字 实 参 的 方式 传递 的 。 在 @@ 处 ， 我 们 设置 了 图 表 标 题 、 副 标 
签 和 主 标签 的 字体 大 小 。 在 这 个 图 表 中 ， 副 标签 是 x 轴 上 的 项 目 名 以 及 y 轴 上 的 大 部 分 数字 。 主 标 
签 是 y 轴 上 为 5000 整 数 倍 的 刻度 ; 这 些 标签 应 更 大 ， 以 与 副 标 签 区 分 开 来 。 在 @ 处 ， 我 们 使 用 
truncate_label 将 较 长 的 项 目 名 缩短 为 15 个 字符 ( 如 果 你 将 鼠标 指向 屏幕 上 被 截 短 的 项 目 名 ， 将 
显示 完整 的 项 目 名 )。 接 下 来 , 我 们 将 show_y_guides 设 置 为 False, 以 隐藏 图 表 中 的 水 平 线 ( 见 @ )。 
最 后 ， 在 @ 处 设置 了 自 定义 宽度 ， 让 图 表 更 充分 地 利用 浏览 器 中 的 可 用 空间 。 
在 @ 处 创建 Bar 实 例 时 ， 我 们 将 my_config 作 为 第 一 个 实 参 ， 从 而 通过 一 个 实 参 传递 了 所 有 的 
配置 设置 。 我 们 可 以 通过 my_config 做 任意 数量 的 样式 和 配置 修改 ， 而 @ 处 的 代码 行将 保持 不 变 
图 17-2 显 示 了 重新 设置 样式 后 的 图 表 。 
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图 17-2 ”改进 了 图 表 的 样式 


17.2.2 ”添加 自 定义 工具 提示 


在 Pygal 中 ,将 鼠标 指向 条 形 将 显示 它 表 示 的 信息 ， 这 通常 称 为 工具 提示 。 在 这 个 示例 中 ， 
当前 显示 的 是 项 目 获得 了 多 少 个 星 。 下 面 来 创建 一 个 自 定义 工具 提示 ， 以 同时 显示 项 目的 描述 。 

来 看 一 个 简单 的 示例 ， 它 可 视 化 前 三 个 项 目 ， 并 给 每 个 项 目 对 应 的 条 形 都 指定 自 定义 标签 。 
为 此 ， 我 们 向 add() 传 递 一 个 字典 列表 ， 而 不 是 值 列表 : 


bar_descriptions.py 


import pygal 
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from pygal.style import LightColorizedStyle as LCS, LightenStyle as LS 


my_style = LS('#333366', base style=LCS) 
chart = pygal.Bar(style=my_style, x label rotation=45, show legend=False) 


chart.title = “Python Projects’ 
chart.x labels = ['httpie', 'django', 'flask'] 


@ plot dicts = [ 
@ { value': 16101, 'label': "Description of httpie.'}, 


{ value': 15028, 'label': “Description of django.'}, 
{'value': 14798, 'label': 'Description of flask.'}, 
] 


@ chart.add('', plot dicts) 
chart.render to file('bar descriptions.svg') 


在 @ 处 ,我 们 定义 了 一 个 名 为 plot_dicts 的 列表 , 其 中 包含 三 个 字典 ,分 别针 对 项 目 HTTPie、 
Django 和 Flask。 每 个 字典 都 包含 两 个 键 :'value' 和 '1abel'。Pygal 根 据 与 键 'value' 相 关联 的 数 
字 来 确定 条 形 的 高 度 ， 并 使 用 与 '1label' 相 关联 的 字符 串 给 条 形 创建 工具 提示 。 例 如 ，@ 处 的 第 
一 个 字典 将 创建 一 个 条 形 ， 用 于 表示 一 个 获得 了 16 101 颗 星 、 工 具 提 示 为 Description of httpie 的 
项 目 。 

方法 add() 接 受 一 个 字符 串 和 一 个 列表 。 这 里 调用 add() 时 ， 我 们 传人 了 一 个 由 表示 条 形 的 字 
典 组 成 的 列表 ( plot dicts ) ( 见 @ )。 图 17-3 显 示 了 一 个 工具 提示 : 除 默 认 工具 提示 (获得 的 星 
数 ) 外 ，Pygal 还 显示 了 我 们 传人 的 自 定义 提示 。 
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图 17-3 


每 个 条 形 


都 有 自 定义 的 工具 提示 标签 
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17.2.3 ”根据 数据 绘图 


为 根据 数据 绘图 ， 我 们 将 自动 生成 plot_dicts， 其 中 包含 API 调 用 返回 的 30 个 项 目的 信息 。 
完成 这 种 工作 的 代码 如 下 : 


python_repos.py 


--SNip-- 

# 研究 有 关 仓 库 的 信息 

repo dicts = response dict[ items ] 
print("Number of items:", len(repo dicts) ) 


@ names, plot dicts = [], [] 
for repo dict in repo dicts: 
names.append(repo dict[ name ']) 


@ plot dict = { 
"value': repo dict['stargazers count'], 
'label': repo dict['description'], 


} 
(3 plot dicts.append(plot dict) 


# 可 视 化 
my_style = LS('#333366', base style=LCS) 
--Snip-- 


@ chart.add('', plot dicts) 
chart.render to file('python repos.svg') 


在 @ 处 ， 我 们 创建 了 两 个 空 列表 names 和 plot_dicts。 为 生成 x 轴 上 的 标签 ， 我 们 依然 需要 列 
表 names。 

在 循环 内 部 ， 对 于 每 个 项 目 ， 我 们 都 创建 了 字典 plot_dict ( 见 @ )。 在 这 个 字典 中 ， 我 们 使 
用 键 'value' 存 储 了 星 数 ， 并 使 用 键 'label' 存 储 了 项 目 描 述 。 接 下 来 ,我 们 将 字典 plot_dict 附 加 
到 plot_dicts 末 尾 ( 见 @ ),。 在 @ 人 处, 我 们 将 列表 plot_dicts 传 递 给 了 add()。 图 17-4 显 示 了 生成 的 
图 表 。 
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图 17-4 将 鼠标 指向 条 形 将 显示 项 目的 描述 


17.2.4 在 图 表 中 添加 可 单 击 的 链接 


Pygal 还 允许 你 将 图 表 中 的 每 个 条 形 用 作 网 站 的 链接 。 为 此 ， 只 需 添加 一 行 代码 ， 在 为 每 个 
项 目 创建 的 字典 中 ， 添 加 一 个 键 为 'xlink' 的 键 - 值 对 : 


python_repos.py 


-- Snip-- 

names, plot dicts = [], [] 

for repo dict in repo dicts: 
names.append(repo dict[ 'name' ]) 


plot dict = { 
'value': repo dict['stargazers count'], 
'label': repo dict['description'], 
‘xlink': repo dict['html url'], 
} 
plot dicts.append(plot dict) 
-- SNip-- 


Pygal 根 据 与 键 'xlink' 相 关联 的 URL 将 每 个 条 形 都 转换 为 活路 的 链接 。 单 击 图表 中 的 任何 条 
形 时 ,都 将 在 浏览 器 中 打开 一 个 新 的 标签 页 ， 并 在 其 中 显示 相应 项 目的 GitHub 页 面 。 至此, 你 对 
API 获 取 的 数据 进行 了 可 视 化 ， 它 是 交互 性 的 ， 包 含 丰 富 的 信息 ! 


17.3 Hacker News API 
为 探索 如 何 使 用 其 他 网 站 的 API 调 用 , 我 们 来 看 看 Hacker News( http:/news.ycombinator com/ )。 
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在 Hacker News 网 站 ， 用 户 分 享 编程 和 技术 方面 的 文章 ， 并 就 这 些 文章 展开 积极 的 讨论 。Hacker 
News 的 APT 让 你 能 够 访问 有 关 该 网 站 所 有 文章 和 评论 的 信息 ， 且 不 要 求 你 通过 注册 获得 密 钥 。 
下 面 的 调用 返回 本 书 编写 时 最 热门 的 文章 的 信息 : 


https://hacker-news.firepaseio.Com/VvO/item/9884165.json 


响应 是 一 个 字典 ， 包 含 ID 为 9884165 的 文章 的 信息 : 


{ 
@ ‘url': 'http://www.bbc.co.uk/news/science-environment-33524589", 
‘type': 'story', 
2 ‘title': 'New Horizons: Nasa spacecraft speeds past Pluto', 
© 'descendants': 141, 
'score': 230， 
‘time': 1436875181， 
EEX 和 
‘by': 'nns', 
“id : 9884165， 
@ 'kids': [9884723，9885099，9884789，9885604，9885844] 
小 


这 个 字典 包含 很 多 键 , 如 'url1' ( 见 @ ) 和 'title' ( 见 @ ), 与 键 'descendants' 相 关联 的 值 是 
文章 被 评论 的 次 数 ( 见 @ )。 与 键 'kids' 相 关联 的 值 包 含 对 文章 所 做 的 所 有 评论 的 ID ( 见 @ )。 每 
个 评论 自己 也 可 能 有 kid， 因 此 文章 的 后 代 ( descendant ) 数量 可 能 比 其 kid 数 量 多 。 

下 面 来 执行 一 个 API 调 用 , 返回 Hacker News 上 当前 热门 文章 的 ID, 再 查看 每 篇 排名 靠 前 的 文章 : 


hn_submissions.py 


import requests 
from operator import itemgetter 


# 执行 API 调 用 并 存储 响应 

@ url = 'https://hacker-news.firebaseio.com/vo/topstories.json’ 
r = requests.get(url 
print("Status code:", r.status code) 


# 处 理 有 关 每 篇 文章 的 信息 
@ submission ids = r.json() 
@ submission dicts = [ 
for submission id in submission ids[:30]: 
# 对 于 每 篇 文章 ， 孝 执行 一 个 API 调 用 
Q url = ( https://hacker-news.firebaseio.Com/VO/item/ ”+ 
str(submission id) + '.json') 
submission TY = requests.get(url) 
print(submission r.status code) 
response dict = submission r.json() 


Ex 


© 


© submission dict = { 
'title': response dict['title'], 
"link': 'http://news.ycombinator.com/item?id="' + str(submission id)， 
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© 'comments': response dict.get('descendants', 0) 


有 


submission dicts.append(submission dict) 


@ submission dicts = sorted(submission dicts, key=itemgetter('comments'), 
reverse=True) 


©@ for submission dict in submission dicts: 
print("\nTitle:", submission dict['title']) 
print("Discussion link:", submission dict['link']) 
print("Comments:", submission dict['comments']) 


首先 , 我 们 执行 了 一 个 API 调 用 ,并 打印 了 响应 的 状态 ( 见 @ )。 这 个 API 调 用 返回 一 个 列表 ， 
其 中 包含 Hacker News 上 当前 最 热门 的 $00 篇 文章 的 ID 。 接 下 来 ， 我 们 将 响应 文本 转换 为 一 个 
Python 列表 ( 见 @ )， 并 将 其 存储 在 submission_ ids 中 。 我们 将 使 用 这 些 ID 来 创建 一 系列 字典 ,其 
中 每 个 字典 都 存储 了 一 篇 文章 的 信息 。 

在 @ 处 ， 我 们 创建 了 一 个 名 为 submission dicts 的 空 列表 ， 用 于 存储 前 面 所 说 的 字典 。 接 下 
来 ,我们 遍历 前 30 篇 文章 的 ID 。 对 于 每 篇 文章 ， 我 们 都 执行 一 个 API 调 用 ， 其 中 的 URL 包 含 
submission_ id 的 当前 值 ( 见 @ )。 我 们 打印 每 次 请 求 的 状态 ， 以 便 知道 请 求 是 否 成 功 了 。 

在 @ 处 ,我们 为 当前 处 理 的 文章 创建 一 个 字典 , 并 在 其 中 存储 文章 的 标题 以 及 到 其 讨论 页 面 
的 链接 。 在 @ 处 ,我 们 在 这 个 字典 中 存储 了 评论 数 。 如 果 文 章 还 没有 评论 ， 响 应 字典 中 将 没有 键 
'descendants' 。 不 确定 某 个 键 是 否 包 含 在 字典 中 时 ， 可 使 用 方法 dict.get()， 它 在 指定 的 键 存在 
时 返回 与 之 相关 联 的 值 ， 并 在 指定 的 键 不 存在 时 返回 你 指定 的 值 (这 里 是 0 )。 最 后 ， 我 们 将 
submission_ dict 附 加 到 submission dicts 末 尾 。 

Hacker News 上 的 文章 是 根据 总 体 得 分 排名 的 ， 而 总 体 得 分 取决 于 很 多 因素 ， 其 中 包含 被 推 
荐 的 次 数 、 评 论 数 以 及 发 表 的 时 间 。 我 们 要 根据 评论 数 对 字典 列表 submission_dicts 进 行 排序 ， 
为 此 , 使 用 了 模块 operator 中 的 函数 itemgetter() ( 见 @ )。 我 们 向 这 个 函数 传递 了 键 'comments ' ， 
因此 它 将 从 这 个 列表 的 每 个 字典 中 提取 与 键 'comments' 相 关联 的 值 。 这 样 ， 函 数 sorted() 将 根据 
这 种 值 对 列表 进行 排序 。 我 们 将 列表 按 降序 排列 ， 即 评论 最 多 的 文章 位 于 最 前 面 。 

对 列表 排序 后 ， 我 们 遍历 这 个 列表 ( 见 @ )， 对 于 每 篇 热门 文章 ， 都 打印 其 三 项 信息 : 标题 、 
到 讨论 页 面 的 链接 以 及 文章 现 有 的 评论 数 : 


Status code: 200 
200 

200 

200 

-- Ship-- 


Title: Firefox deactivates Flash by default 
Discussion link: http://news.ycombinator.com/item?id=9883246 
Comments: 231 


Title: New Horizons: Nasa spacecraft speeds past Pluto 
Discussion link: http://news.ycombinator.com/item?id=9884165 
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Comments: 142 


Title: Iran Nuclear Deal Is Reached With World Powers 
Discussion link: http://news.ycombinator.com/item?id=9884005 
Comments: 141 


Title: Match Group Buys PlentyOfFish for $575M 
Discussion link: http://news.ycombinator.com/item?id=9884417 
Comments: 75 


Title: Our Nexus 4 devices are about to explode 
Discussion link: http://news.ycombinator.com/item?id=9885625 
Comments: 14 


-- Snip-- 


使 用 任何 API 来 访问 和 分 析 信 息 时 ， 流 程 都 与 此 类 似 。 有 了 这 些 数据 后 ， 你 就 可 以 进行 可 视 


化 ， 指 出 最 近 哪 些 文章 引发 了 最 激烈 的 讨论 。 


动手 试 一 斌 


17-1 其 他 语言 : 修改 python repos.py 中 的 API 调 用 ， 使 其 在 生成 的 图 表 中 显示 使 
用 其 他 语言 编写 的 最 受 欢迎 的 项 目 。 请 尝试 语言 JavaScript Ruby、C、 Java、 Perl、 Haskell 
和 Go 等 。 

17-2 最 活跃 的 讨论 :使 用 hn submissions.py 中 的 数据 ,创建 一 个 条 形 图 ,显示 Hacker 


News 上 当前 最 活跃 的 讨论 。 条 形 的 高 度 应 对 应 于 文章 得 到 的 评论 数量 ， 条 形 的 标签 应 
包含 文章 的 标题 ， 而 每 个 条 形 应 是 到 该 文章 讨论 页 面 的 链接 。 

17-3 测试 python repos.py: 在 python repos.py 中 ， 打 印 status code 的 值 ， 以 核 
实 API 调 用 是 否 成 功 了 。 请 编写 一 个 名 为 test_python repos.py 的 程序 ， 它 使 用 单元 测试 
来 断言 status_code 的 值 为 200。 想 想 你 还 可 做 出 哪些 断言 ， 如 返回 的 条 目 数 符合 预期 ， 
仓库 总 数 超过 特定 的 值 等 。 


17.4 ”小 结 


在 本 章 中 ， 你 学 习 了 : 如 何 使 用 API 来 编写 独立 的 程序 ， 它 们 自动 采集 所 需 的 数据 并 对 其 进 
行 可 视 化 ; 使 用 GitHub API 来 探索 GitHub 上 星 级 最 高 的 Python 项 目 , 还 大 致 地 了 解 了 Hacker News 
API; 如 何 使 用 requests 包 来 自动 执行 GitHub API 调 用 ， 以 及 如 何 处 理 调用 的 结果 。 我 们 还 简要 地 
介绍 了 一 些 Pygal 设 置 ， 使 用 它们 可 进一步 定制 生成 的 图 表 的 外 观 。 

在 本 书 的 最 后 一 个 项 目 中 ， 我 们 将 使 用 Django 来 创建 一 个 Web 应 用 程序 。 


项 目 3 Web 应 用 程序 


Django 入 门 


当今 的 网 站 实际 上 都 是 富 应 用 程序 (rich application )， 就 像 成 熟 
的 桌面 应 用 程序 一 样 。Python 提 供 了 一 组 开发 Web 应 用 程序 的 卓越 工 
有 具 。 在 本 章 中 ， 你 将 学 习 如 何 使 用 Django (http://djangoproject.com/ ) 
来 开发 一 个 名 为 “学 习 笔 记 ”( LearningLog ) 的 项 目 , 这 是 一 个 在 线 
日 志 系统 ， 让 你 能 够 记录 所 学 习 的 有 关 特 定 主题 的 知识 。 

我 们 将 为 这 个 项 目 制定 规范 , 然后 为 应 用 程序 使 用 的 数据 定义 模 
型 。 我 们 将 使 用 Django 的 管理 系统 来 输入 一 些 初 始 数据 ,再 学 习 编 写 
视图 和 模板 ， 让 Django 能 够 为 我 们 的 网 站 创建 网 页 。 

Dijango 是 一 个 Web 框 架 一 一 一 套用 于 帮助 开发 交互 式 网 站 的 工 
具 。Django 能 够 响应 网 页 请 求 ， 还 能 让 你 更 轻松 地 读 写 数 据 库 、 管 理 用 户 等 。 在 第 19 章 和 第 
20 章 ， 我 们 将 改进 “学 习 笔 记 ” 项 目 ， 再 将 其 部 署 到 活动 的 服务 器 ， 让 你 和 你 的 朋友 能 够 使 
用 它 。 


18.1 建立 项 目 


建立 项 目 时 , 首先 需要 以 规范 的 方式 对 项 目 进行 描述 , 再 建立 虚拟 环境 , 以 便 在 其 中 创建 项 目 。 
18.1.1 制定 规范 


完整 的 规范 详细 说 明了 项 目的 目标 ,阐述 了 项 目的 功能 ， 并 讨论 了 项 目的 外 观 和 用 户 界面 。 
与 任何 良好 的 项 目 规划 和 商业 计划 书 一 样 , 规范 应 突出 重点 , 帮助 避免 项 目 偏 离 轨道 。 这 里 不 会 
制定 完整 的 项 目 规划 ， 而 只 列 出 一 些 明 确 的 目标 ， 以 突出 开发 的 重点 。 我 们 制定 的 规范 如 下 : 


我 们 要 编写 一 个 名 为 “学 习 笔 记 ” 的 Web 应 用 程序 ， 让 用 户 能 够 记录 感 兴趣 的 主 
题 ， 并 在 学 习 每 个 主题 的 过 程 中 添加 日 志 条 目 。“ 学 习 笔记 ”的 主页 对 这 个 网 站 进行 描 
述 ， 并 邀请 用 户 注册 或 登录 。 用 户 登 录 后 ， 就 可 创建 新 主题 、 添 加 新 条 目 以 及 阅读 有 既 
有 的 条 目 。 
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学 习 新 的 主题 时 , 记录 学 到 的 知识 可 帮助 跟踪 和 复习 这 些 知 识 。 优秀 的 应 用 程序 让 这 个 记录 
过 程 简单 易 行 。 


18.1.2 ”建立 虚拟 环境 


要 使 用 Django， 首 先 需要 建立 一 个 虚拟 工作 环境 。 虚 拟 环境 是 系统 的 一 个 位 置 ， 你 可 以 在 其 
中 安装 包 ， 并 将 其 与 其 他 Python 包 隔离 。 将 项 目的 库 与 其 他 项 目 分 离 是 有 益 的 ， 且 为 了 在 第 20 章 
将 “学 习 笔记 ”部 署 到 服务 副 ， 这 也 是 必须 的 。 

为 项 目 新 建 一 个 目录 , 将 其 命名 为 learning_log, 青 在 终端 中 切换 到 这 个 目录 , 并 创建 一 个 虚 
拟 环 境 。 如 果 你 使 用 的 是 Python 3， 可 使 用 如 下 命令 来 创建 虚拟 环境 : 


learning log$ python -m venv 11_env 
learning log$ 


这 里 运行 了 模块 venv， 并 使 用 它 来 创建 一 个 名 为 1 env 的 虚拟 环境 。 如 果 这 样 做 管用 ， 请 跳 
到 后 面 的 18.1.4 节 ; 如 果 不 管用 ， 请 阅读 18.1.3 节 。 


18.1.3 ”安装 virtualenv 


如 果 你 使 用 的 是 较 早 的 Python 版 本 ， 或 者 系统 没有 正确 地 设置 ， 不 能 使 用 模块 venv， 可 安装 
virtualenv 包 。 为 此 ， 可 执行 如 下 命令 : 


$ pip install --user Virtualenv 


别 忘 了 ， 对 于 这 个 命令 ， 你 可 能 需要 使 用 稍微 不 同 的 版 本 (如 果 你 没有 使 用 过 pip ， 请 参阅 
12.2.1 节 )。 


注意 ”如果 你 使 用 的 是 Linux 系 统 ， 且 上 面 的 做 法 不 管用 ， 可 使 用 系统 的 包 管 理 器 来 安装 
Virtualenv。 例 如 ， 要 在 Ubuntu 系统 中 安装 virtualenv， 可 使 用 命令 sudo apt-get instal1 
python-virtualenv。 


在 终端 中 切换 到 目录 learning log， 并 像 下 面 这 样 创建 一 个 虚拟 环境 : 


learning log$ virtualenv 1] env 

New python executable in 1] env/bin/python 
Installing setuptools, pip...done. 
learning log$ 


注意 如 果 你 的 系统 安装 了 多 个 Python 版 本 ， 需 要 指定 virtualenv 使 用 的 版 本 。 例 如 ， 命令 
virtualenv 11 env --python=python3 创 建 一 个 使 用 Python 3 的 虚拟 环境 。 
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18.1.4 ”激活 虚拟 环境 
建立 虚拟 环境 后 ， 需 要 使 用 下 面 的 命令 激活 它 : 


learning log$ Source 1] env/bin/activate 
@ (1] env)learning log$ 


这 个 命令 运行 1 env/bin 中 的 脚本 activate。 环境 处 于 活动 状态 时 , 环境 名 将 包含 在 括号 内 ， 如 
@ 处 所 示 。 在 这 种 情况 下 ， 你 可 以 在 环境 中 安装 包 ， 并 使 用 已 安装 的 包 。 你 在 1L_env 中 安装 的 包 
仅 在 该 环境 处 于 活动 状态 时 才 可 用 。 


注意 ”如果 你 使 用 的 是 Windows 系 统 ， 请 使 用 命令 11 env\Scripts\activate (不 包含 source ) 来 
激活 这 个 虚拟 环境 。 


要 停止 使 用 虚拟 环境 ， 可 执行 命令 deactivate: 


(11 env)learning log$ deactivate 
learning log$ 


如 果 关 闭 运行 虚拟 环境 的 终端 ， 虚 拟 环境 也 将 不 再 处 于 活动 状态 。 


18.1.5 安装 Django 
创建 并 激活 虚拟 环境 后 ， 就 可 安装 Django 了 : 


(11 env)learning log$ pip install Django 
Installing collected packages: Django 
Successfully installed Django 

Cleaning up... 

(11 env)learning log$ 


由 于 我 们 是 在 虚拟 环境 中 工作 ， 因 此 在 所 有 的 系统 中 , 安装 Django 的 命令 都 相同 : 不 需要 指 
定 标志 --user， 也 无 需 使 用 python -m pip install package_name 这 样 较 长 的 命令 。 
别 忘 了 ，Django 仅 在 虚拟 环境 处 于 活动 状态 时 才 可 用 。 


18.1.6 ”在 Django 中 创建 项 目 
在 依然 处 于 活动 的 虚拟 环境 的 情况 下 (11_env 包 含 在 括号 内 ), 执行 如 下 命令 来 新 建 一 个 项 目 : 


@ (1] env)learning log$ django-admin.py startproject learning log 
@ (11 env)learning log$ 1s 

learning log ]]1_env manage.py 
@ (1]1 env)learning log$ ls learning log 

_init .py settings.py urls.py wsgi.py 
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@ 处 的 命令 让 Django 新 建 一 个 名 为 learning log 的 项 目 。 这 个 命令 末尾 的 句点 让 新 项 目 使 用 合 
适 的 目录 结构 ， 这 样 开 发 完成 后 可 轻松 地 将 应 用 程序 部 署 到 服务 器 。 


注意 千 万 别 忘 了 这 个 句点 ,否则 部 署 应 用 程序 时 将 遭遇 一 些 配置 问题 。 如 果 忘 记 了 这 个 句点 ， 
就 将 创建 的 文件 和 文件 夹 删 除 (1 env 除 外 )， 再 重新 运行 这 个 命令 。 


在 @ 处 ， 运 行 了 命令 ls ( 在 Windows 系 统 上 应 为 dir )， 结 果 表 明 Django 新 建 了 一 个 名 为 
learning log 的 目录 。 它 还 创建 了 一 个 名 为 manage.py 的 文件 ， 这 是 一 个 简单 的 程序 ， 它 接受 命令 
并 将 其 交 给 Django 的 相关 部 分 去 运行 。 我 们 将 使 用 这 些 命令 来 管理 诸如 使 用 数据 库 和 运行 服务 器 
等 任务 。 

目录 learning log 包 含 4 个 文件 ( 见 @ )， 其 中 最 重要 的 是 settings.py、urlspy 和 wsgipy。 文 件 
settings.py 指 定 Django 如 何 与 你 的 系统 交互 以 及 如 何 管理 项 目 。 在 开发 项 目的 过 程 中 ， 我 们 将 修 
改 其 中 一 些 设置 ， 并 添加 一 些 设置 。 文 件 urls.py 告 诉 Django 应 创建 哪些 网 页 来 响应 浏览 器 请 求 。 
文件 wsgi.py 帮 助 Django 提 供 它 创 建 的 文件 ， 这 个 文件 名 是 web server gateway interface ( Web 服 务 
器 网 关 接 口 ) 的 首 字母 缩写 。 


18.1.7 创建 数据 库 


Django 将 大 部 分 与 项 目 相 关 的 信息 都 存储 在 数据 库 中 ， 因 此 我 们 需要 创建 一 个 供 Django 使 
用 的 数据 库 。 为 给 项 目 “ 学 习 笔 记 ” 创 建 数据 库 ， 请 在 处 于 活动 虚拟 环境 中 的 情况 下 执行 下 面 


的 命令 : 


(1] env)learning log$ python manage.py migrate 
@ Operations to perform: 
Synchronize unmigrated apps: messages, staticfiles 
Apply all migrations: contenttypes, sessions, auth, admin 
-- Snip-- 
Applying sessions.0001 initial... OK 
@ (ll env)learning log$ 1s 
db.sqlite3 learning log 1] env manage.py 


我 们 将 修改 数据 库 称 为 迁移 数据 库 。 首 次 执行 命令 migrate 时 ， 将 让 Django 确 保 数据 库 与 项 
目的 当前 状态 匹配 。 在 使 用 SQLite ( 后面 将 更 详细 地 介绍 ) 的 新 项 目 中 首次 执行 这 个 命令 时 ， 
Django 将 新 建 一 个 数据 库 。 在 @ 处 ，Django 指 出 它 将 创建 必要 的 数据 库 表 ， 用 于 存储 我 们 将 在 这 
个 项 目 (Synchronize unmigrated apps， 同 步 未 迁移 的 应 用 程序 ) 中 使 用 的 信息 ， 再 确保 数据 库 结 
构 与 当前 代码 (Apply all migrations， 应 用 所 有 的 迁移 ) 匹配 。 

在 @ 处 ， 我 们 运行 了 命令 l1s， 其 输出 表明 Django 叉 创建 了 一 个 文件 一 一 db.sqlite3。SQLite 是 
一 种 使 用 单个 文件 的 数据 库 , 是 编写 简单 应 用 程序 的 理想 选择 ,因为 它 让 你 不 用 太 关注 数据 库 管 
理 的 问题 。 


18.1.8 查看 项 目 
下 面 来 核实 Django 是 否 正确 地 创建 了 项 目 。 为 此 ， 可 执行 命令 runserver， 如 下 所 示 : 


(11 env)learning log$ python manage.py runserver 
Performing system checks... 


@ System check identified no issues (0 silenced). 

July 15, 2015 - 06:23:51 
@ Django version 1.8.4, using settings 'learning log.settings’' 
四 Starting development server at http://127.0.0.1:8000/ 

Quit the server with CONTROL-C. 


Django 启 动 一 个 服务 器 ， 让 你 能 够 查看 系统 中 的 项 目 ， 了 解 它们 的 工作 情况 。 当 你 在 浏览 妖 
中 输入 URL 以 请 求 网 页 时 , 该 Django 服 务 器 将 进行 响应 : 生成 合适 的 网 页 , 并 将 其 发 送 给 浏览 器 。 

在 @ 人 处 ，Django 通 过 检查 确认 正确 地 创建 了 项 目 ; 在 @ 处 ， 它 指出 了 使 用 的 Django 版 本 以 及 
当前 使 用 的 设置 文件 的 名 称 ; 在 四 处 ， 它 指出 了 项 目的 URL。URLhttp:/127.0.0.1:8000/ 表 明 项 目 
将 在 你 的 计算 机 ( 即 localhost ) 的 端口 8000 上 侦 听 请 求 。localhost 是 一 种 只 处 理 当 前 系统 发 出 的 
请 求 ， 而 不 允许 其 他 任何 人 查看 你 正在 开发 的 网 页 的 服务 器 。 

现在 打开 一 款 Web 浏 览 器 ， 并 输入 URL : http://localhost:8000/; 如 果 这 不 管用 ， 请 输入 
http://127.0.0.1:8000/。 你 将 看 到 类 似 于 图 18-1 所 示 的 页 面 ， 这 个 页 面 是 Django 创 建 的 ， 让 你 知道 
到 目前 为 止 一 切 正 常 。 现 在 暂时 不 要 关闭 这 个 服务 吉 。 若 要 关闭 这 个 服务 吉 ， 按 Ctrl + C 即 可 。 


Welcome to Django - Chromium 
DWelcometoDjango x 


如 @ | 口 localhost8000 | = 


It worked! 
Congratulations on your first Django-powered page. 


Of course, you haven't actually done any work yet. Next, start your first app by running python manage.py startapp [app_label]. 


You're seeing this message because you have DEBUG = True in your Django settings file and you haven't configured any URLs. Get to work! 


图 18-1 ”到 目前 为 止 一 切 正常 i 


注意 ”如果 出 现 错误 消息 “That port is already in use”( 指定 端口 已 被 占用 )， 请 执行 命令 python 
manage.py runserver 8001， 让 Diango 使 用 另 一 个 端口 ; 如 果 这 个 端口 也 不 可 用 ， 请 不 断 
执行 上 述 命令 ， 并 逐渐 增 大 其 中 的 端口 号 ， 直 到 找到 可 用 的 端口 。 
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动手 试 一 斌 
18-1 新 项 目 : 为 更 深入 地 了 解 Django 做 了 些 什么 , 可 创建 两 个 空 项 目 , 看 看 Django 
创建 了 什么 。 新 建 一 个 文件 夹 ， 并 给 它 指定 简单 的 名 称 ， 如 InstaBook 或 FaceGram (不 
要 在 目录 learning log 中 新 建 该 文件 夹 ), 在 终端 中 切换 到 该 文件 来 ,并 创建 一 个 虚拟 环 


境 。 在 这 个 虚拟 环境 中 安装 Django， 并 执行 命令 django-admin.py startproject 
instabook. ( 千 万 不 要 忘 了 这 个 命令 末尾 的 句点 )。 

看 看 这 个 命令 创建 了 哪些 文件 和 文件 夹 ， 并 与 项 目 “ 学 习 笔 记 ” 包 含 的 文件 和 文件 
夹 进行 比较 。 这 样 多 做 几 次 ， 直 到 对 Django 新 建 项 目 时 创建 的 东西 了 如 指 掌 。 然 后 ， 
将 项 目 目 录 删 除 一 一 如 果 你 想 这 样 做 的 话 。 


18.2 创建 应 用 程序 


Dijango 项 目 由 一 系列 应 用 程序 组 成 ,它们 协同 工作 , 让 项 目 成 为 一 个 整体 。 我 们 暂时 只 创建 
一 个 应 用 程序 ， 它 将 完成 项 目的 大 部 分 工作 。 在 第 19 章 ,我们 将 再 添加 一 个 管理 用 户 账 户 的 应 用 
程序 。 

当前 ， 在 前 面 打开 的 终端 窗口 中 应 该 还 运行 着 runserver。 请 再 打开 一 个 终端 窗口 〈 或 标签 
页 )， 并 切换 到 manage.py 所 在 的 目录 。 激 活该 虚拟 环境 ， 再 执行 命令 startapp: 


learning log$ source 1] env/bin/activate 
(11 env)learning log$ python manage.py startapp learning logs 
@ (ll env)learning log$ 1s 
db.sqlite3 learning log learning logs 1] env manage.py 
@ (ll env)learning log$ ls learning logs/ 
admin.py _ init .py migrations models.py tests.py views.py 


命令 startapp appnamei 上 .Django 建立 创建 应 用 程序 所 需 的 基础 设施 。 如 果 现 在 查看 项 目 目 录 ， 
将 看 到 其 中 新 增 了 一 个 文件 夹 learning_ logs ( 见 @ )。 打 开 这 个 文件 来， 看 看 Django 都 创建 了 什么 
( 见 @ )。 其 中 最 重要 的 文件 是 models.py、admin.py 和 views.py。 我 们 将 使 用 models.py 来 定义 我 们 
要 在 应 用 程序 中 管理 的 数据 。admin.py 和 views.py 将 在 稍 后 介绍 。 


18.2.1 定义 模型 


我 们 来 想 想 涉及 的 数据 。 每 位 用 户 都 需要 在 学 习 笔记 中 创建 很 多 主题 。 用 户 输入 的 每 个 条 目 
都 与 特定 主题 相关 联 ,这些 条 目 将 以 文本 的 方式 显示 。 我 们 还 需要 存储 每 个 条 目的 时 间 惟 ,以 便 
能 够 告诉 用 户 各 个 条 目 都 是 什么 时 候 创建 的 。 

打开 文件 models.py， 看 看 它 当 前 包含 哪些 内 容 : 
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models.py 


from django.db import models 


# 在 这 里 创建 模型 


这 为 我 们 导入 了 模块 models， 还 让 我 们 创建 自己 的 模型 。 模 型 告诉 Django 如 何 处 理应 用 程序 
中 存储 的 数据 。 在 代码 层面 ， 模 型 就 是 一 个 类 ， 就 像 前 面 讨论 的 每 个 类 一 样 ， 包 含 属性 和 方法 。 
下 面 是 表示 用 户 将 要 存储 的 主题 的 模型 : 


from django.db import models 


class Topic(models.Model) : 
© text = models.CharField(max_length=200) 
@ date added = models.DateTimeField(auto now add=True) 


(3 def _str (self) : 
"" "返回 模型 的 字符 囊 表示 """ 
return self.text 


我 们 创建 了 一 个 名 为 Topic 的 类 ， 它 继承 了 Model 一 一 Django 中 一 个 定义 了 模型 基本 功能 的 
类 。Topic 类 只 有 两 个 属性 : text 和 date_added。 

属性 text 是 一 个 CharField 一 一 由 字符 或 文本 组 成 的 数据 ( 见 @ )。 需 要 存储 少量 的 文本 ， 如 
名 称 、 标 题 或 城市 时 ， 可 使 用 charField。 定 义 CharField 属 性 时 ， 必 须 告诉 Django 该 在 数据 库 中 
预 留 多 少 空间 。 在 这 里 ， 我 们 将 max_length 设 置 成 了 200( 即 200 个 字符 )， 这 对 存储 大 多 数 主题 
名 来 说 足够 了 。 

属性 date_added 是 一 个 DateTimeField 一 一 记录 日 期 和 时 间 的 数据 ( 见 @ )。 我们 传递 了 实 参 
auto_add_now=True， 每 当 用 户 创建 新 主题 时 ， 这 都 让 Django 将 这 个 属性 自动 设置 成 当前 日 期 和 
时 间 。 


注意 要 获悉 可 在 模型 中 使 用 的 各 种 字段 ， 请 参阅 Django Model Field Reference( Django 模 型 字 
段 参 考 )， 其 网 址 为 https://docs.djangoproject.com/en/1.8/ref/models/fields/。 就 当前 而 言 ， 
你 无 需 全 面 了 解 其 中 的 所 有 内 容 , 但 自己 开发 应 用 程序 时 ， 这 些 内 容 会 提供 极 大 的 帮助 。 


我 们 需要 告诉 Django ， 默 认 应 使 用 哪个 属性 来 显示 有 关 主 题 的 信息 。Django 调 用 方法 
_str () 来 显示 模型 的 简单 表示 。 在 这 里 ,我 们 编写 了 方法 ”str ()， 它 返回 存储 在 属性 text 
中 的 字符 串 ( 见 @ )。 


注意 ”如果 你 使 用 的 是 Python 2.7， 应 调用 方法 _unicode ()， 而 不 是 _str ()， 但 其 中 的 代 
码 相同 。 
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18.2.2 ”激活 模型 


要 使 用 模型 ， 必 须 让 Django 将 应 用 程序 包含 到 项 目 中 。 为 此 ， 打 开 settings.py ( 它 位 于 目录 
learning_ log/learning log 中 )， 你 将 看 到 一 个 这 样 的 片段 ， 即 告诉 Django 哪 些 应 用 程序 安装 在 项 
目 中 : 


settings.py 


--SNnip-- 

INSTALLED APPS = ( 
“django.contTib.admin ， 
‘django.contrib.auth', 
‘django.contrib.contenttypes', 
'django.contrib.sessions', 
'django.contrib.messages', 
“django.contTrib.staticfiles ， 


) 


--SNnip-- 


这 是 一 个 元 组 ， 告 诉 Django 项 目 是 由 哪些 应 用 程序 组 成 的 。 请 将 INSTALLED_APPS 修 改 成 下 面 
这 样 ， 将 前 面 的 应 用 程序 添加 到 这 个 元 组 中 : 


--Ship-- 
INSTALLED APPS = ( 
--SNip-- 


‘django.contrib.staticfiles', 


# 我 的 应 用 程序 
'learning logs', 
) 


--Ship-- 


通过 将 应 用 程序 编组 ,在 项 目 不 断 增 大 , 包含 更 多 的 应 用 程序 时 ， 有 助 于 对 应 用 程序 进行 跟 
踪 。 这 里 新 建 了 一 个 名 为 My apps 的 片段 ， 当 前 它 只 包含 应 用 程序 learning logs。 

接 下 来 ， 需 要 让 Django 修 改 数 据 库 ， 使 其 能 够 存储 与 模型 Topic 相 关 的 信息 。 为 此 ， 在 终端 
窗口 中 执行 下 面 的 命令 : 


(11_env)learning_ log$ python manage.py makemigrations learning logs 
Migrations for 'learning logs': 
0001 initial.py: 
- Create model Topic 
(1] env)learning log$ 


命令 makemigrations 让 Django 确 定 该 如 何 修改 数据 库 ， 使 其 能 够 存储 与 我 们 定义 的 新 模型 相 
关联 的 数据 。 输 出 表明 Django 创 建 了 一 个 名 为 0001_initial.py 的 迁移 文件 , 这 个 文件 将 在 数据 库 中 
为 模型 Topic 创 建 一 个 表 。 

下 面 来 应 用 这 种 迁移 ， 让 Django 替 我 们 修改 数据 库 : 


18.2 ”创建 应 用 程序 363 


(11_env)learning log$ python manage.py migrate 
--SNnip-- 
Running migrations: 
Rendering model states... DONE 
@ Applying learning logs.0001 initial... OK 


这 个 命令 的 大 部 分 输出 都 与 我 们 首次 执行 命令 migrate 的 输出 相同 。 我们 需要 检查 的 是 @ 处 的 
输出 行 ， 在 这 里 ，Django 确 认为 learning logs 应 用 迁移 时 一 切 正常 (OK )。 

每 当 需 要 修改 “学 习 笔 记 ” 管 理 的 数据 时 ， 都 采取 如 下 三 个 步骤 : 修改 models.py; 对 
learning logs 调 用 makemigrations; 让 Django 迁 移 项 目 。 


18.2.3 ”Django 管理 网 站 


为 应 用 程序 定义 模型 时 ，Django 提 供 的 管理 网 站 (admin site ) 让 你 能 够 轻松 地 处 理 模型 。 网 
站 的 管理 员 可 使 用 管理 网 站 , 但 普通 用 户 不 能 使 用 。 在 本 节 中 , 我 们 将 建立 管理 网 站 ， 并 通过 它 
使 用 模型 Topic 来 添加 一 些 主 题 。 

1. 创建 超级 用 户 

Django 人 允许 你 创建 具备 所 有 权限 的 用 户 超级 用 户 。 权 限 决定 了 用 户 可 执行 的 操作 。 最 严 
格 的 权限 设置 只 允许 用 户 阅 读 网 站 的 公开 信息 ; 注册 了 的 用 户 通常 可 阅读 自己 的 私有 数据 , 还 可 
查看 一 些 只 有 会 员 才 能 查看 的 信息 。 为 有 效 地 管理 Web 应 用 程序 ， 网 站 所 有 者 通常 需要 访问 网 站 
存储 的 所 有 信息 。 优秀 的 管理 员 会 小 心 对 待 用 户 的 敏感 信息 ,因为 用 户 对 其 访问 的 应 用 程序 有 极 
大 的 信任 。 

为 在 Django 中 创建 超级 用 户 ， 请 执行 下 面 的 命令 并 按 提示 做 : 


| 


(11_env)learning log$ python manage.py createsuperuser 
@ Username (leave blank to use 'ehmatthes'): 11 admin 
@ Email address: 
四 Password: 

Password (again): 

Superuser created successfully. 

(11 env)learning log$ 


你 执行 命令 createsuperuser 时 ，Django 提 示 你 输入 超级 用 户 的 用 户 名 ( 见 @ )。 这 里 我 们 输 
入 的 是 1 admin,， 但 你 可 以 输入 任何 用 户 名 ， 比 如 电子 邮件 地 址 ， 也 可 让 这 个 字段 为 空 ( 见 @ )。 
你 需要 输入 密码 两 次 ( 见 @ )。 


注意 可 能 会 对 网 站 管理 员 隐 藏 有 些 敏感 信息 。 例 如 ，Django 并 不 存储 你 输入 的 密码 ， 而 存储 
从 该 密码 派生 出 来 的 一 个 字符 串 一 一 艇 列 值 。 每 当 你 输入 密码 时 ，Django 都 计算 其 散 列 
值 ， 并 将 结果 与 存储 的 散 列 值 进行 比较 。 如 果 这 两 个 散 列 值 相 同 ， 就 通过 了 身份 验证 。 
通过 存储 散 列 值 ， 即 便 黑 客 获得 了 网 站 数据 库 的 访问 权 ， 也 只 能 获取 其 中 存储 的 散 列 值 ， 
而 无 法 获得 密码 。 在 网 站 配置 正确 的 情况 下 ， 几 乎 无 法 根据 散 列 值 推导 出 原始 密码 。 
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2. 向 管理 网 站 注册 模型 

Django 自 动 在 管理 网 站 中 添加 了 一 些 模 型 ， 如 User 和 Group， 但 对 于 我 们 创建 的 模型 ， 必 须 
手工 进行 注册 。 

我 们 创建 应 用 程序 learning_ logs 时，Django 在 models.py 所 在 的 目录 中 创建 了 一 个 名 为 
admin.py 的 文件 : 


admin.py 


from django.contrib import admin 


# 在 这 里 注册 你 的 模型 


为 向 管理 网 站 注册 Topic， 请 输入 下 面 的 代码 : 


from django.contrib import admin 


@ from learning logs.models import Topic 


@ admin.site.register(Topic) 


这 些 代 码 导 入 我 们 要 注册 的 模型 Topic ( 见 @ )， 再 使 用 admin.site.register()( 见 @) 让 
Django 通 过 管理 网 站 管理 我 们 的 模型 。 

现在 ， 使 用 超级 用 户 账 户 访问 管理 网 站 : 访问 http://localhost:8000/admin/， 并 输入 你 刚 创建 
的 超级 用 户 的 用 户 名 和 密码 ,你 将 看 到 类 似 于 图 18-2 所 示 的 屏幕 。 这 个 网 页 让 你 能 够 添加 和 修改 
用 户 和 用 户 组 ， 还 可 以 管理 与 刚才 定义 的 模型 Topic 相 关 的 数据 。 


Site administration | Django site admin - Chromium 


DD Site administration |[ x 


@ | localhost:8000/admin/ ?了 x 


Django administration 


Welcome, ILadmin. Change password / Log out 


Site administration 


Recent Actions 


Groups 


中 Add Change My Actions 
Users 中 Add 少 Change 中 Django 
oF 
中 Python 
Topics 


中 Add Change 


图 18-2 ”包含 模型 Topic 的 管理 网 站 
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注意 ”如果 你 在 浏览 器 中 看 到 一 条 消息 ， 指 出 访问 的 网 页 不 可 用 ,请 确认 你 在 终端 窗口 中 运行 
着 Django 服 务 器 。 如 果 没 有 ， 请 激活 虚拟 环境 ， 并 执行 命令 python manage.py runserver。 


3. 添加 主题 

向 管理 网 站 注册 Topic 后 ,我 们 来 添加 第 一 个 主题 。 为 此 , 单 击 Topics 进 入 主题 网 页 ， 它 几乎 
是 空 的 ， 这 是 因为 我 们 还 没有 添加 任何 主题 。 单 击 Add， 你 将 看 到 一 个 用 于 添加 新 主题 的 表单 。 
在 第 一 个 方 框 中 输入 Chess， 再 单 击 Save， 这 将 返回 到 主题 管理 页 面 ， 其 中 包含 刚 创建 的 主题 。 

下 面 再 创建 一 个 主题 ， 以 便 有 更 多 的 数据 可 供 使 用 。 再 次 单 击 Add， 并 创建 另 一 个 主题 Rock 
Climbing。 当 你 单 击 Save 时 ， 将 重新 回 到 主题 管理 页 面 ， 其 中 包含 主题 Chess 和 Rock Climbing。 


18.2.4 定义 模型 Entry 


要 记录 学 到 的 国际 象棋 和 攀岩 知识 ,需要 为 用 户 可 在 学 习 笔 记 中 添加 的 条 目 定 义 模型 。 每 个 
条 目 都 与 特定 主题 相关 联 ， 这 种 关系 被 称 为 多 对 一 关系 ， 即 多 个 条 目 可 关联 到 同一 个 主题 。 
下 面 是 模型 Entry 的 代码 : 


models.py 


from django.db import models 


class Topic(models.Model): 


--SNnip-- 


@ class Entry(models.Model): 
""" 学 到 的 有 关 某 个 主题 的 具体 知识 """ 
© topic = models.ForeignKey(Topic) 
(3 text = models.TextField() 
date added = models.DateTimeField(auto now add=True) 


Q class Meta: 
verbose name plural = 'entries' 


def str (self): 
""" 返 回 模型 的 字符 事 表 示 """ 
9 return self.text[:50] + "..." 


像 Topic 一 样 ，Entry 也 继承 了 Django 基 类 Model ( 见 @ )。 第 一 个 属性 topic 是 一 个 ForeignKey 实 
例 ( 见 @ )。 外 键 是 一 个 数据 库 术语 ， 它 引用 了 数据 库 中 的 另 一 条 记录 ; 这 些 代码 将 每 个 条 目 关 联 
到 特定 的 主题 。 每 个 主题 创建 时 ,都 给 它 分 配 了 一 个 键 (或 ID )。 需 要 在 两 项 数据 之 间 建 立 联系 时 ， 
Django 使 用 与 每 项 信息 相关 联 的 键 。 稍 后 我 们 将 根据 这 些 联系 获取 与 特定 主题 相关 联 的 所 有 条 目 。 

接 下 来 是 属性 text， 它 是 一 个 TextField 实 例 ( 见 @ )。 这 种 字段 不 需要 长 度 限制 ， 因 为 我 们 
不 想 限 制 条 目的 长 度 。 属 性 date_added 让 我 们 能 够 按 创 建 顺序 呈现 条 目 ， 并 在 每 个 条 目 旁 边 放 置 
时 间 惟 。 
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在 @ 处 , 我 们 在 Entry 类 中 般 套 了 Meta 类 。Meta 存 储 用 于 管理 模型 的 额外 信息 ,在 这 里 , 它 让 
我 们 能 够 设置 一 个 特殊 属性 ， 让 Django 在 需要 时 使 用 Entries 来 表示 多 个 条 日。 如果 没有 这 个 类 ， 
Django 将 使 用 Entrys 来 表示 多 个 条 目 。 最 后 , 方法 _str () 告 诉 Django， 呈 现 条 目 时 应 显示 哪些 
信息 。 由 于 条 目 包 含 的 文本 可 能 很 长 ， 我 们 让 Django 只 显示 text 的 前 50 个 字符 ( 见 @ )。 我 们 还 
添加 了 一 个 省 略 号 ， 指 出 显示 的 并 非 整个 条 目 。 


18.2.5 ”迁移 模型 Entry 


由 于 我 们 添加 了 一 个 新 模型 ， 因 此 需要 再 次 迁移 数据 库 。 你 将 慢 慢 地 对 这 个 过 程 了 如 指 掌 
修改 models.py ， 执 行 命令 python manage.py makemigrations app mame， 再 执行 命令 python 
manage.py migrate。 


下 面 来 迁移 数据 库 并 查看 输出 : 


(1] env)learning log$ python manage.py makemigrations learning logs 
Migrations for 'learning logs': 
@ 0002 entry.py: 
- Create model Entry 
(11_ env)learning log$ python manage.py migrate 
Operations to perform: 
--SNnip-- 
@ Applying learning logs.0002 entry... OK 


生成 了 一 个 新 的 迁移 文件 一 一 0002_entry.py， 它 告诉 Django 如 何 修改 数据 库 ， 使 其 能 够 存储 
与 模型 Entry 相 关 的 信息 ( 见 @ ), 执行 命令 migrate, 我 们 发 现 Django 应 用 了 这 种 迁移 日 一 切 顺 利 
( 见 @ )。 


18.2.6 ”向 管理 网 站 注册 Entry 
我 们 还 需要 注册 模型 Entry。 为 此 ， 需 要 将 admin.py 修 改 成 类 似 于 下 面 这 样 : 


admin.py 


from django.contrib import admin 
from learning logs.models import Topic, Entry 


admin.site.register(Topic) 
admin.site.register(Entry) 


返回 到 http://localhost/admin/, 你 将 看 到 learning logs 下 列 出 了 Entries。 单 击 Entries 的 Add 链 接 ， 
或 者 单 击 Entries 再 选择 Add entry。 你 将 看 到 一 个 下 拉 列 表 , 让 你 能 够 选择 要 为 哪个 主题 创建 条 目 ， 
还 有 一 个 用 于 输入 条 目的 文本 框 。 从 下 拉 列 表 中 选择 Chess， 并 添加 一 个 条 目 。 下 面 是 我 添加 的 


第 一 个 条 目 。 
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The opening ls the first part of the game, roughly the first ten moves or so. In the opening, it's a 
good idea to do three things— bring out your bishops and knights, try to control the center of the 
board, and castle your king.( 国际 象棋 的 第 一 个 阶段 是 开局 ， 大致 是 前 10 步 左右 。 在 开局 阶 
段 ， 最 好 做 三 件 事情 : 将 象 和 马 调 出 来 ; 努力 控制 棋盘 的 中 间 区 域 ， 用 车 将 王 护 住 。) 

Of course, these are just guidelines. It will be important to learn when to follow these 
guidelines and when to disregard these suggestions. ( 当然 ， 这 些 只 是 指导 原则 。 学 习 什 么 
情况 下 遵守 这 些 原则 、 什 么 情况 下 不 用 遵守 很 重要 。) 


当 你 单 击 Save 时 ， 将 返回 到 主 条 目 管 理 页 面 。 在 这 里 ， 你 将 发 现 使 用 text[ :50] 作 为 条 目的 
字符 串 表 示 的 好 处 : 管理 界面 中 ,只 显示 了 条 目的 开头 部 分 而 不 是 其 所 有 文本 ,这 使 得 管理 多 个 
条 


再 来 创建 一 个 国际 象棋 条 目 ， 并 创建 一 个 攀岩 条 目 ， 以 提供 一 些 初始 数据 。 下 面 是 第 二 个 国 
际 象棋 条 目 。 


In the opening phase of the game, it's important to bring out your bishops and knights. 
These pieces are powerful and maneuverable enough to play a significant role in the beginning 
moves of a game. (在 国际 象棋 的 开局 阶段 ， 将 象 和 马 调 出 来 很 重要 。 这 些 棋子 威力 大 ， 
机 动 性 强 ， 在 开局 阶段 扮演 着 重要 角色 。 ) 


下 面 是 第 一 个 攀岩 条 目 : 


One of the most Important concepts in climbing is to keep your weight on your feet as 
much as possible. There’s a myth that climbers can hang all day on their arms. In reality, good 
climbers have practiced Specific ways of keeping their weight over their feet whenever possible. 
(最 重要 的 攀岩 概念 之 一 是 尽 可 能 让 双 脚 承受 体重 。 有 裹 误 认为 攀岩 者 能 依靠 手臂 的 力 
量 坚持 一 整 天 。 实 际 上 ,优秀 的 枫 岩 者 都 经 过 专门 训练 ， 能 够 尽 可 能 让 双 脚 承受 体重 。) 


继续 往 下 开发 “学 习 笔 记 ” 时 ， 这 三 个 条 目 可 为 我 们 提供 使 用 的 数据 。 
18.2.7 Django shell 


输入 一 些 数据 后 , 就 可 通过 交互 式 终端 会 话 以 编程 方式 查看 这 些 数 据 了 。 这 种 交互 式 环境 称 
为 Django shell， 是 测试 项 目 和 排除 其 故障 的 理想 之 地 。 下 面 是 一 个 交互 式 shell 会 话 示例 : 


1] env)learning log$ python manage.py shell 
@ >>> from learning logs.models import Topic 
>>> Topic.objects.all() 

<Topic: Chess>, <Topic: Rock Climbing>] 


在 活动 的 虚拟 环境 中 执行 时 ， 命 令 python manage.py shell 启 动 一 个 Python 解 释 器 ， 可 使 用 
它 来 探索 存储 在 项 目 数据 库 中 的 数据 。 在 这 里 ， 我 们 导入 了 模块 learning_logs .models 中 的 模型 
Topic ( 见 @ ), 然后 使 用 方法 Topic.objects.all() 来 获取 模型 Topic 的 所 有 实例 ; 它 返回 的 是 一 个 
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列表 ， 称 为 查询 集 ( queryset )。 
我 们 可 以 像 遍历 列表 一 样 遍历 查询 集 。 下 面 演 示 了 如 何 查 看 分 配给 每 个 主题 对 象 的 ID: 


>>> topics = Topic.objects.all() 
>>> for topic in topics: 
print(topic.id, topic) 


1 Chess 


2 Rock Climbing 
我 们 将 返回 的 查询 集 存 储 在 topics 中 ,然后 打印 每 个 主题 的 id 属 性 和 字符 串 表示 。 从 输出 可 


知 ， 主 题 Chess 的 ID 为 1， 而 Rock Climbing 的 ID 为 2。 
知道 对 象 的 ID 后 ， 就 可 获取 该 对 象 并 查看 其 任何 属性 。 下 面 来 看 看 主题 Chess 的 属性 text 和 
date added 的 值 : 


>>> t = Topic.objects.get(id=1) 

>>> 七 .text 

‘Chess" 

>>> t.date added 

datetime.datetime(2015, 5, 28, 4, 39, 11, 989446, tzinfo=<UTC>) 

我 们 还 可 以 查看 与 主题 相关 联 的 条 目 。 前 面 我 们 给 模型 Entry 定 义 了 属性 topic， 这 是 一 个 
ForeignKey， 将 条 目 与 主题 关联 起 来 。 利 用 这 种 关联 ，Django 能 够 获取 与 特定 主题 相关 联 的 所 有 
条 目 ， 如 下 所 示 : 

@ >>> t.entry set.all() 


[<Entry: The opening is the first part of the game, roughly...>, <Entry: In the opening phase of the 
game, it's important t...>] 


为 通过 外 键 关 系 获取 数据 ， 可 使 用 相关 模型 的 小 写 名 称 、 下 划 线 和 单词 set ( 见 @ )。 例 如 ， 
假设 你 有 模型 Pizza 和 Topping, 而 Topping 通 过 一 个 外 键 关 联 到 Pizza; 如 果 你 有 一 个 名 为 my_pizza 
的 对 象 ， 表示 一 张 比萨 ,就 可 使 用 代码 my_pizza.topping_ set.all() 来 获取 这 张 比萨 的 所 有 配料 。 
编写 用 户 可 请 求 的 网 页 时 , 我们 将 使 用 这 种 语法 。 确 认 代 码 能 获取 所 需 的 数据 时 ，shell 很 有 
帮助 。 如 果 代 码 在 shell 中 的 行为 符合 预期 ,那么 它们 在 项 目 文件 中 也 能 正确 地 工作 。 如 果 代 码 引 
发 了 错误 或 获取 的 数据 不 符合 预期 , 那么 在 简单 的 shell 环 境 中 排除 故障 要 比 在 生成 网 页 的 文件 中 
排除 故障 容易 得 多 。 我 们 不 会 太 多 地 使 用 shell, 但 应 继续 使 用 它 来 熟悉 对 存储 在 项 目 中 的 数据 进 
行 访问 的 Django 语 法 。 


注意 每 次 修改 模型 后 ， 你 都 需要 重启 shell， 这 样 才能 看 到 修改 的 效果 。 要 退出 shell 会 话 ， 可 
按 Ctr +D; 如 果 你 使 用 的 是 Windows 系 统 ， 应 按 Ctr 十 Z， 再 按 回 车 键 。 
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动手 试 一 斌 


18-2 简短 的 条 目 : 当前 ，Django 在 管理 网 站 或 shell 中 显示 Entry 实例 时 ， 模 型 
Entry 的 方法 _str _() 都 在 它 的 末尾 加 上 省 略 号 。 请 在 方法 _str () 中 添加 一 条 if 
语句 ， 以 便 仅 在 条 目 长 度 超 过 50 字符 时 才 添 加 省 略 号 。 使 用 管理 网 站 来 添加 一 个 长 度 
少 于 50 字符 的 条 目 ， 并 核实 显示 它 时 没有 省 略 号 。 

18-3 Django API: 编写 访问 项 目 中 的 数据 的 代码 时 ， 你 编写 的 是 查询 。 请 浏览 
关 如 何 查询 数据 的 文档 ,其 网 址 为 https://docs.djangoproject.com/en/7.8/topics/db/queries/。 


其 中 大 部 分 内 容 都 是 你 不 熟悉 的 ， 但 等 你 自己 开发 项 目 时 ， 这 些 内 容 会 很 有 用 。 

18-4 比萨 店 : 新 建 一 个 名 为 pizzeria 的 项 目 ， 并 在 其 中 添加 一 个 名 为 pizzas 的 应 
用 程序 。 定 义 一 个 名 为 Pizza 的 模型 , 它 包 含 字 段 name, 用 于 存储 比萨 名 称 , 如 Hawaiian 
和 Meat Lovers。 定 义 一 个 名 为 Topping 的 模型 ， 它 包含 字段 pizza 和 name， 其 中 字段 
pizza 是 一 个 关联 到 Pizza 的 外 键 , 而 字段 name 用 于 存储 配料 ,如 pineapple、Canadian 
bacon 和 sausage。 

向 管理 网 站 注册 这 两 个 模型 ， 并 使 用 管理 网 站 输入 一 些 比 萨 名 和 配料 。 使 用 shell 
来 查看 你 输入 的 数据 。 
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使 用 Django 创 建 网 页 的 过 程 通常 分 三 个 阶段 : 定义 URL、 编 写 视 图 和 编写 模板 。 首 先 ， 你 必 
须 定 义 URL 模 式 。URL 模 式 描 述 了 URL 是 如 何 设计 的 ， 让 Django 知 道 如 何 将 浏览 器 请 求 与 网 站 
UREL 匹 配 ， 以 确定 返回 哪个 网 页 。 

每 个 URL 都 被 映射 到 特定 的 视图 一 一 视图 函数 获取 并 处 理 网 页 所 需 的 数据 ,视图 函数 通常 调 
用 一 个 模板 , 后 者 生成 浏览 器 能 够 理解 的 网 页 。 为 明白 其 中 的 工作 原理 ,我 们 来 创建 学 习 笔 记 的 
主页 。 我 们 将 定义 该 主页 的 URL、 编 写 其 视图 函数 并 创建 一 个 简单 的 模板 。 

鉴于 我 们 只 是 要 确保 “学 习 笔 记 ” 按 要 求 的 那样 工作 ， 我 们 将 暂时 让 这 个 网 页 尽 可 能 简单 。 
Web 应 用 程序 能 够 正常 运行 后 ， 设 置 样式 可 使 其 更 有 趣 ， 但 中 看 不 中 用 的 应 用 程序 毫 无 意义 。 就 
目前 而 言 ， 主 页 只 显示 标题 和 简单 的 描述 。 


18.3.1 映射 URL 


用 户 通 过 在 浏览 器 中 输入 URL 以 及 单 击 链接 来 请 求 网 页 ， 因 此 我 们 需要 确定 项 目 需 要 哪些 
URL。 主 页 的 URL 最 重要 ， 它 是 用 户 用 来 访问 项 目的 基础 URL。 当 前 ， 基 础 URL 
( http://localhost:8000/ ) 返回 默认 的 Django 网 站 ,让 我 们 知道 正确 地 建立 了 项 目 。 我 们 将 修改 这 一 
点 ， 将 这 个 基础 URL 映 射 到 “学 习 笔记 ”的 主页 。 

打开 项 目 主 文件 夹 learning log 中 的 文件 urls.py， 你 将 看 到 如 下 代码 : 
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urls.py 


@ from django.conf.urls import include, url 
from django.contrib import admin 


@ urlpatterns = [ 
(3 url(r'^admin/', include(admin.site.urls)), 


前 两 行 导入 了 为 项 目 和 管理 网 站 管理 URL 的 函数 和 模块 ( 见 @ )。 这 个 文件 的 主体 定义 了 变 
量 urlpatterns( 见 @ )。 在 这 个 针对 整个 项 目的 urls.py 文 件 中 ， 变 量 urlpatterns 包 含 项 目 中 的 应 
用 程序 的 URL。@ 处 的 代码 包含 模块 admin.site.urls, 该 模块 定义 了 可 在 管理 网 站 中 请 求 的 所 有 
URL。 

我 们 需要 包含 learning logs 的 URL: 


from django.conf.urls import include, url 
from django.contrib import admin 


urlpatterns = |[ 
url(r'^admin/', include(admin.site.urls)), 
© url(r'', include('learning logs.urls', namespace='learning logs')), 


在 @ 人 处， 我 们 添加 了 一 行 代码 来 包含 模块 learning logs.urls 。 这 行 代码 包含 实 参 
namespace ,让 我 们 能 够 将 learning_logs 的 URL 同 项 目 中 的 其 他 URL 区 分 开 来 , 这 在 项 目 开 始 扩 
展 时 很 有 帮助 。 
默认 的 urls.py 包 含 在 文件 夹 learning _ log 中， 现在 我 们 需要 在 文件 夹 learning_logs 中 创建 男 一 
个 urls.py 文 件 : 


urls.py 


@""" 定 义 learning logs 的 URL 模 式 """ 


@ from django.conf.urls import url 
@ from . import views 
@ urlpatterns = [ 
# 主页 
【5) url(r'^$', views.index, name="'index'), 


为 乔 清楚 当前 位 于 哪个 urls.py 文 件 中 ， 我 们 在 这 个 文件 开头 添加 了 一 个 文档 字符 串 ( 见 @ )。 
接 下 来 ,我 们 导 人 了 函数 url1， 因 为 我 们 需要 使 用 它 来 将 URL 上 映射 到 视图 ( 见 @ )。 我们 还 导入 了 
模块 views ( 见 @ )， 其 中 的 句点 让 Python 从 当前 的 urls.py 模 块 所 在 的 文件 夹 中 导入 视图 。 在 这 个 
模块 中 ， 变 量 urlpatterns 是 一 个 列表 ， 包 含 可 在 应 用 程序 learning logs 中 请 求 的 网 页 ( 见 @ )。 
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实际 的 URL 模 式 是 一 个 对 函数 urlL() 的 调用 ， 这 个 函数 接受 三 个 实 参 ( 见 @ )。 第 一 个 是 一 个 
正则 表达 式 。 Django 在 urlpatterns 中 查找 与 请 求 的 URL 字 符 串 匹 配 的 正则 表达 式 , 因此 正则 表达 
式 定 义 了 Django 可 查找 的 模式 。 

我 们 来 看 看 正则 表达 式 r'^$' 。 其 中 的 riFPython 将 接 下 来 的 字符 串 视 为 原始 字符 串 ， 而 引号 
告诉 Python 正则 表达 式 始 于 和 终于 何 处 。 脱 字符 (^ ) 让 Python 查看 字符 串 的 开头 ， 而 美元 符号 让 
Python 查看 字符 串 的 末尾 。 总 体 而 言 ， 这 个 正则 表达 式 让 Python 查找 开头 和 末尾 之 间 没 有 任何 东 
西 的 URL。Python 忽 略 项 目的 基础 URL ( http://localhost:8000/ )， 因 此 这 个 正则 表达 式 与 基础 URL 
匹配 。 其 他 URL 都 与 这 个 正则 表达 式 不 匹配 。 如 果 请 求 的 URL 不 与 任何 URL 模 式 匹配 ，Django 
将 返回 一 个 错误 页 面 。 

ur1() 的 第 二 个 实 参 ( 见 @ ) 指 定 了 要 调用 的 视图 函数 ,请 求 的 URL 与 前 述 正则 表达 式 匹配 时 ， 
Django 将 调用 views .index( 这 个 视图 函数 将 在 下 一 节 编 写 )。 第 三 个 实 参 将 这 个 URL 模 式 的 名 称 
指定 为 iIndex， 让 我 们 能 够 在 代码 的 其 他 地 方 引 用 它 。 每 当 需 要 提供 到 这 个 主页 的 链接 时 ， 我 们 
都 将 使 用 这 个 名 称 ， 而 不 编写 URL。 


注意 正则 表达 式 通 常 被 称 为 regex， 几 乎 每 种 编程 语言 都 使 用 它 。 它 们 的 用 途 多 得 难以 置信 ， 
但 需要 经 过 一 定 的 练习 才能 熟悉 。 如 果 你 不 明白 前 面 介绍 的 内 容 ， 也 不 用 担心 ， 你 在 完 
成 这 个 项 目的 过 程 中 ， 将 会 看 到 很 多 正则 表达 式 。 


18.3.2 ”编写 视图 

视图 函数 接受 请 求 中 的 信息 , 准备 好 生成 网 页 所 需 的 数据 , 再 将 这 些 数据 发 送 给 浏览 器 一 一 
这 通常 是 使 用 定义 了 网 页 是 什么 样 的 模板 实现 的 。 

learning logs 中 的 文件 views.py 是 你 执行 命令 python manage.py startapp 时 自动 生成 的 ， 当 前 
其 内 容 如 下 : 


views.py 


from django.shortcuts import render 
# 在 这 里 创建 视图 


当前 ， 这 个 文件 只 导入 了 函数 render()， 它 根据 视图 提供 的 数据 演 染 响应 。 下 面 的 代码 演示 
了 该 如 何 为 主页 编写 视图 : 


from django.shortcuts import render 


def index(request): 
mmm 学 习 笔 记 的 主页 """ 
return render(request, 'learning logs/index.html') 
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URL 请 求 与 我 们 刚才 定义 的 模式 匹配 时 ，Django 将 在 文件 views.py 中 查找 函数 index() ， 再 将 
请 求 对 象 传递 给 这 个 视图 函数 。 在 这 里 ,我 们 不 需要 处 理 任何 数据 ， 因 此 这 个 函数 只 包含 调用 
render() 的 代码 。 这 里 向 函数 render() 提 供 了 两 个 实 参 : 原始 请 求 对 象 以 及 一 个 可 用 于 创建 网 页 
的 模板 。 下 面 来 编写 这 个 模板 。 


18.3.3 ”编写 模板 


模板 定义 了 网 页 的 结构 。 模 板 指 定 了 网 页 是 什么 样 的 ， 而 每 当 网 页 被 请 求 时 ，Django 将 填 入 
相关 的 数据 。 模 板 让 你 能 够 访问 视图 提供 的 任何 数据 。 我 们 的 主页 视图 没有 提供 任何 数据 ， 因 此 
相应 的 模板 非常 简单 。 

在 文件 夹 learning logs 中 新 建 一 个 文件 夹 , 并 将 其 命名 为 ttmplates。 在 文件 夹 templates 中 ,再 
新 建 一 个 文件 来， 并 将 其 命名 为 learning_logs。 这 好 像 有 点 多 余 ( 我 们 在 文件 夹 learning_logs 中 创 
建 了 文件 夹 templates ， 叉 在 这 个 文件 夹 中 创建 了 文件 夹 learning logs ), 但 建立 了 Django 能 够 明确 
解读 的 结构 ， 即 便 项 目 很 大 ， 包含 很 多 应 用 程序 亦 如 此 。 在 最 里 面 的 文件 夹 learning_ logs 中 ， 新 
建 一 个 文件 ， 并 将 其 命名 为 index.html， 再 在 这 个 文件 中 编写 如 下 代码 : 


index.html 


<p>Learning Log</p> 


<p>Learning Log helps you keep track of your learning, for any topic you Te 
learning about.</p> 


这 个 文件 非常 简单 。 对 于 不 熟悉 HTML 的 读者 , 这 里 解释 一 下 : 标签 cp></p> 标 识 段落 ; 标签 
<p> 指 出 了 段落 的 开头 位 置 ， 而 标签 </p> 指 出 了 段落 的 结束 位 置 。 这 里 定义 了 两 个 段落 : 第 一 个 
充当 标题 ， 第 二 个 阐述 了 用 户 可 使 用 “学 习 笔 记 ” 来 做 什么 。 

现在 ， 如 果 你 请 求 这 个 项 目的 基础 URL 一 一 http://localhost:8000/， 将 看 到 刚才 创建 的 网 页 ， 
而 不 是 默认 的 Django 网 页 。Django 接 受 请 求 的 URL， 发 现 该 URL 与 模式 r'^$' 匹 配 ， 因 此 调用 函 
数 views.index()， 这 将 使 用 index.html 包 含 的 模板 来 泻 染 网 页 ， 结 果 如 图 18-3 所 示 。 


localhost:8000 - Chromium 


DD localhost:8000 关 
€ 3 © [D localhost:8000 六 | 三 
Learning Log 


Learning Log helps you keep track of your learning, for any topic you're learning about. 


图 18-3 ”学 习 笔 记 的 主页 
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创建 网 页 的 过 程 看 起 来 可 能 很 复杂 , 但 将 URL 、 视 图 和 模板 分 离 的 效果 实际 上 很 好 。 这 让 我 
们 能 够 分 别 考虑 项 目的 不 同方 面 , 且 在 项 目 很 大 时 ,让 各 个 参与 者 可 专注 于 其 最 擅长 的 方面 。 例 
如 ， 数 据 库 专家 可 专注 于 模型 ， 程 序 员 可 专注 于 视图 代码 ， 而 Web 设 计 人 员 可 专注 于 模板 。 


动手 试 一 斌 
18-S 膳食 规划 程序 : 假设 你 要 创建 一 个 应 用 程序 , 帮助 用 户 规划 一 周 的 膳食 。 为 此 ， 


新 建 一 个 文件 夹 ，, 并 将 其 命名 为 meal planner, 再 在 这 个 文件 夹 中 新 建 一 个 Django 项目 。 
接 下 来 ， 新 建 一 个 名 为 meal plans 的 应 用 程序 ， 并 为 这 个 项 目 创建 一 个 简单 的 主页 。 
18-6 比萨 店主 页 : 在 你 为 完成 练习 18-4 而 创建 的 项 目 Pizzeria 中 ， 添 加 一 个 主页 。 


18.4 创建 其 他 网 页 


制定 创建 网 页 的 流程 后 ， 可 以 开始 扩充 “学 习 笔 记 ” 项 目 了 。 我 们 将 创建 两 个 显示 数据 的 网 
页 ,其 中 一 个 列 出 所 有 的 主题 , 男 一 个 显示 特定 主题 的 所 有 条 目 。 对 于 每 个 网 页 , 我们 都 将 指定 
URIL 模 式 ,， 编写 一 个 视图 函数 ， 并 编写 一 个 模板 。 但 这 样 做 之 前 ,我 们 先 创建 一 个 父 模 板 , 项 目 
中 的 其 他 模板 都 将 继承 它 。 


18.4.1 ”模板 继承 


创建 网 站 时 ， 几 乎 都 有 一 些 所 有 网 页 都 将 包含 的 元 素 。 在 这 种 情况 下 ， 可 编写 一 个 包含 通用 
元 素 的 父 模板 ， 并 让 每 个 网 页 都 继承 这 个 模板 ， 而 不 必 在 每 个 网 页 中 重复 定义 这 些 通用 元 素 。 这 
种 方法 能 让 你 专注 于 开发 每 个 网 页 的 独特 方面 ， 还 能 让 修改 项 目的 整体 外 观 容易 得 多 。 

1. 父 模 板 

我 们 首先 来 创建 一 个 名 为 base.html 的 模板 , 并 将 其 存储 在 index.html 所 在 的 目录 中 。 这 个 文件 
包含 所 有 页 面 都 有 的 元 素 ; 其 他 的 模板 都 继承 base.html。 当 前 ， 所 有 页 面 都 包含 的 元 素 只 有 顶端 
的 标题 。 我 们 将 在 每 个 页 面 中 包含 这 个 模板 ， 因 此 我 们 将 这 个 标题 设置 为 到 主页 的 链接 : 


base.html 


<p> 
@ «a href="{% url 'learning logs:index' %}">Learning Log</a> 
</p> 


@ {% block content %}{% endblock content %} 


这 个 文件 的 第 一 部 分 创建 一 个 包含 项 目 名 的 段落 , 该 段落 也 是 一 个 到 主页 的 链接 。 为 创建 链 
接 ， 我 们 使 用 了 一 个 模板 标签 ， 它 是 用 大 括号 和 百 分 号 ({% %} ) 表示 的 。 模 板 标签 是 一 小 段 代 
码 ， 生 成 要 在 网 页 中 显示 的 信息 。 在 这 个 实例 中 ,模板 标签 {% url 'learning logs:index' %} 
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生成 一 个 URL， 该 URL 与 learning logs/urls.py 中 定义 的 名 为 index 的 URL 模 式 匹 配 ( 见 @ )。 在 这 
个 示例 中 ，learning logs 是 一 个 命名 空间 ， 而 index 是 该 命名 空间 中 一 个 名 称 独特 的 URL 模 式 。 
在 简单 的 HTML 页 面 中 ,链接 是 使 用 锚 标 签 定义 的 : 


<a href="link url">link text</a> 


让 模板 标签 来 生成 URL, 可 让 链接 保持 最 新 容易 得 多 。 要 修改 项 目 中 的 URL, 只 需 修改 urls.py 
中 的 URL 模 式 ， 这样 网 页 被 请 求 时 ，Django 将 自动 插入 修改 后 的 URL。 在 我 们 的 项 目 中 ,每 个 网 
页 都 将 继承 base.html， 因 此 从 现在 开始 ， 每 个 网 页 都 包含 到 主页 的 链接 。 

在 @ 处 ,我 们 插入 了 一 对 块 标签 。 这 个 块 名 为 content， 是 一 个 占 位 符 ， 其 中 包含 的 信息 将 
由 子 模板 指定 。 

子 模板 并 非 必须 定义 父 模 板 中 的 每 个 块 ， 因 此 在 父 模板 中 ， 可 使 用 任意 多 个 块 来 预 留 空间 ， 
而 子 模板 可 根据 需要 定义 相应 数量 的 块 。 


注意 ”在 Python 代 码 中 , 我 们 几乎 总 是 缩 进 四 个 空格 。 相 比 于 Python 文 件 ， 模板 文件 的 缩 进 层级 
更 多 ， 因 此 每 个 层级 通常 只 缩 进 两 个 空格 。 


2. 子 模板 
现在 需要 重新 编写 index.html， 使 其 继承 base.html， 如 下 所 示 : 


index.html 


©@ {% extends "learning logs/base.html" %} 


@ {% block content %} 
<p>Learning Log helps you keep track of your learning, for any topic you're 
learning about.</p> 

四 {% endblock content %} 


如 果 将 这 些 代 码 与 原来 的 index.html 进 行 比 较 ， 可 发 现 我 们 将 标题 Learning Log 替 换 成 了 从 父 
模板 那里 继承 的 代码 ( 见 @ )。 子 模板 的 第 一 行 必须 包含 标签 {% extends %}， 让 Django 知 道 它 继 
承 了 哪个 父 模板 。 文 件 base.html 位 于 文件 夹 learning logs 中 , 因此 父 模板 路 径 中 包含 learning logs。 
这 行 代 码 导 入 模板 base.html 的 所 有 内 容 ， 让 index.html 能 够 指定 要 在 content 块 预 留 的 空间 中 添加 
的 内 容 。 

在 @ 处 ,我 们 插入 了 一 个 名 为 content 的 {% block %} 标 签 ， 以 定义 content 块 。 不 是 从 父 模板 
继承 的 内 容 都 包含 在 content 块 中 ， 在 这 里 是 一 个 描述 项 目 “ 学 习 笔记 ”的 段落 。 在 @ 处 ， 我 们 
使 用 标签 {% endblock content %} 指 出 了 内 容 定 义 的 结束 位 置 。 

模板 继承 的 优点 开始 显现 出 来 了 : 在 子 模板 中 ， 只 需 包含 当前 网 页 特有 的 内 容 。 这 不 仅 简 化 
了 每 个 模板 ,还 使 得 网 站 修改 起 来 容易 得 多 。 要 修改 很 多 网 页 都 包含 的 元 素 ， 只 需 在 父 模板 中 修 
改 该 元 素 , 你 所 做 的 修改 将 传导 到 继承 该 父 模 板 的 每 个 页 面 。 在 包含 数 十 力 至 数 百 个 网 页 的 项 目 
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中 ， 这 种 结构 使 得 网 站 改进 起 来 容易 而 且 快捷 得 多 。 


注意 在 大 型 项 目 中 ,通常 有 一 个 用 于 整个 网 站 的 父 模板 base.html， 且 网 站 的 每 个 主要 部 
分 都 有 一 个 父 模 板 。 每 个 部 分 的 父 模 板 都 继承 base.html， 而 网 站 的 每 个 网 页 都 继承 相应 
部 分 的 父 模板 。 这 让 你 能 够 轻松 地 修改 整个 网 站 的 外 观 、 网 站 任何 一 部 分 的 外 观 以 及 任 
何 一 个 网 页 的 外 观 。 这 种 配置 提供 了 一 种 效率 极 高 的 工作 方式 ， 让 你 乐意 不 断 地 去 改进 


18.4.2 ”显示 所 有 主题 的 页 面 


有 了 高 效 的 网 页 创建 方法 ,就 能 专注 于 另外 两 个 网 页 了 : 显示 全 部 主题 的 网 页 以 及 显示 特定 
主题 中 条 目的 网 页 。 所 有 主题 页 面 显 示 用 户 创 建 的 所 有 主题 ， 它 是 第 一 个 需要 使 用 数据 的 网 页 。 

1. URL 模 式 

首先 , 我 们 来 定义 显示 所 有 主题 的 页 面 的 URL。 通常 ,使 用 一 个 简单 的 URL 片 段 来 指出 网 页 
显示 的 信息 ; 我 们 将 使 用 单词 topics， 因 此 URL http://localhost:8000/topics/ 将 返回 显示 所 有 主题 的 
页 面 。 下 面 演示 了 该 如 何 修改 learning logs/urls.py: 


urls.py 


""" 为 learning logs 定 义 URL 模 式 """ 

--SNnip-- 

urlpatterns = [ 
# 主页 
url(r'^$', views.index, name='index'), 
# 显示 所 有 的 主题 


© url(r'^topics/$', views.topics, name='topics'), 


] 


我 们 只 是 在 用 于 主页 URL 的 正则 表达 式 中 添加 了 topics/( 见 @ ), Django 检 查 请 求 的 URL 时 ， 
这 个 模式 与 这 样 的 URL 匹 配 ， 基础 URL 后 面 跟 着 topics。 可 以 在 末尾 包含 斜 本 ， 也 可 以 省 略 它 ， 
但 单词 topics 后 面 不 能 有 任何 东西 ,否则 就 与 该 模式 不 匹配 。 其 URL 与 该 模式 匹配 的 请 求 都 将 交 
给 views.py 中 的 函数 topics() 进 行 处 理 。 

2. 视图 

函数 topics() 需 要 从 数据 库 中 获取 一 些 数据 ， 并 将 其 发 送 给 模板 。 我 们 需要 在 views.py 中 添 
加 的 代码 如 下 : 


views.py 


from django.shortcuts import render 


@ from .models import Topic 
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def index(request): 
--Snip-- 


@ def topics(Tequest ) : 
""”" 显 示 所 有 的 主题 ” 
(3 topics = Topic.objects.order by('date added') 
@ context = {'topics': topics} 
9 return render(request, 'learning logs/topics.html', context) 


我 们 首先 导入 了 与 所 需 数据 相关 联 的 模型 ( 见 @ )。 函数 topics() 包 含 一 个 形 参 : Django 从 服 
务 右 那里 收 到 的 request 对 象 ( 见 @ )。 在 @ 处 , 我 们 查询 数据 库 一 一 请 求 提供 Topic 对 象 ， 并 按 属 
性 date_added 对 它们 进行 排序 。 我 们 将 返回 的 查询 集 存储 在 topics 中 。 

在 @ 处 , 我 们 定义 了 一 个 将 要 发 送 给 模板 的 上 下 文 。 上 下 文 是 一 个 字典 ， 其 中 的 键 是 我 们 将 
在 模板 中 用 来 访问 数据 的 名 称 ， 而 值 是 我 们 要 发 送 给 模板 的 数据 。 在 这 里 ， 只 有 一 个 键 - 值 对 ， 
它 包含 我 们 将 在 网 页 中 显示 的 一 组 主题 。 创 建 使 用 数据 的 网 页 时 ， 除 对 象 request 和 模板 的 路 径 
外 ， 我 们 还 将 变量 context 传 递 给 render() ( 见 @ )。 

3. 模板 

显示 所 有 主题 的 页 面 的 模板 接受 字典 context, 以 便 能 够 使 用 topics() 提 供 的 数据 。 请 创建 一 
个 文件 ,将 其 命名 为 topics.html， 并 存储 到 index.html 所 在 的 目录 中 。 下 面 演 示 了 如 何在 这 个 模板 
中 显示 主题 : 


topics.html 


{% extends "learning logs/base.html" %} 
{% block content %} 
<p>Topics</p> 


<ul> 
{% for topic in topics %} 

1i>{{ topic }}</1i> 

{% empty %} 

li>No topics have been added yet.</1i> 
{% endfor %} 

</ul> 


oo Goeoeoe 
八 八 


{% endblock content %} 


就 像 模 板 index.html 一 样 ， 我 们 首先 使 用 标签 {% extends %} 来 继承 base.html， 再 开始 定义 
content 块 。 这 个 网 页 的 主体 是 一 个 项 目 列表 ,其 中 列 出 了 用 户 输入 的 主题 。 在 标准 HTML 中 , 项 
目 列表 被 称 为 无 序列 表 ， 用 标签 cul></ul> 表 示 。 包 含 所 有 主题 的 项 目 列表 始 于 @ 处 。 

在 @ 处 ， 我 们 使 用 了 一 个 相当 于 for 循 环 的 模板 标签 ， 它 遍历 字典 context 中 的 列表 topics。 
模板 中 使 用 的 代码 与 Python 代码 存在 一 些 重要 差别 : Python 使 用 缩 进 来 指出 哪些 代码 行 是 for 循 环 
的 组 成 部 分 ， 而 在 模板 中 ， 每 个 for 循 环 都 必须 使 用 {% endfor %} 标 签 来 显 式 地 指出 其 结束 位 置 。 
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因此 在 模板 中 ， 循 环 类 似 于 下 面 这 样 : 


{% for item in 71ist %} 
do something with each item 
{% endfor %} 


在 循环 中 , 我 们 要 将 每 个 主题 转换 为 一 个 项 目 列表 项 。 要 在 模板 中 打印 变量 , 需要 将 变量 
用 双 花 括号 括 起 来 。 每 次 循环 时 ，@ 处 的 代码 {{ topic }} 都 被 蔡 换 为 topic 的 当前 值 。 这 些 花 括 
号 不 会 出 现在 网 页 中 , 它们 只 是 用 于 告诉 Django 我 们 使 用 了 一 个 模板 变量 。 HTML 标 签 <li></1i> 
表示 一 个 项 目 列表 项 ， 在 标签 对 <ul></u1> 内 部 ， 位 于 标签 di> 和 </1i> 之 间 的 内 容 都 是 一 个 项 目 
列表 项 。 

在 @ 人 处， 我 们 使 用 了 模板 标签 {% empty %}， 它 告诉 Django 在 列表 topics 为 空 时 该 怎么 办 : 这 
里 是 打印 一 条 消息 ， 告 诉 用 户 还 没有 添加 任何 主题 。 最 后 两 行 分 别 结束 for 循 环 ( 见 @ ) 和 项 目 
列表 ( 见 @ )。 

现在 需要 修改 父 模 板 ， 使 其 包含 到 显示 所 有 主题 的 页 面 的 链接 : 


base.html 


<p> 
@ «a href="{% url 'learning logs:index' %}">Learning Log</a> - 
@ «a href="{% url 'learning logs:topics' %}">Topics</a> 

</p> 


{% block content %}{% endblock content %} 


我 们 在 到 主页 的 链接 后 面 添 加 了 一 个 连 字符 ( 见 @ )， 然 后 添加 了 一 个 到 显示 所 有 主题 的 页 
面 的 链接 一 一 使 用 的 也 是 模板 标签 url( 见 @ ), 这 一 行 让 Django 生 成 一 个 链接 , 它 与 learning_logs/ 
urls.py 中 名 为 topics 的 URL 模 式 匹配 。 

现在 如 果 你 刷新 浏览 器 中 的 主页 ， 将 看 到 链接 Topics。 单 击 这 个 链接 ， 将 看 到 类 似 于 图 18-4 
所 示 的 网 页 。 


localhost:8000/topics/ - Chromium 


癌 localhost:8000/topics x 


3 © BD localhost:8000/topics/ 区 三 


Learning Log - Iopics 
Topics 


。 Chess 
。 Rock Climbing 


图 18-4 ”显示 所 有 主题 的 网 页 
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18.4.3 ”显示 特定 主题 的 页 面 


接 下 来 , 我 们 需要 创建 一 个 专注 于 特定 主题 的 页 面 一 一 显示 该 主题 的 名 称 及 该 主题 的 所 有 条 
目 。 同 样 ， 我 们 将 定义 一 个 新 的 URL 模 式 ， 编 写 一 个 视图 并 创建 一 个 模板 。 我 们 还 将 修改 显示 所 
有 主题 的 网 页 ， 让 每 个 项 目 列表 项 都 是 一 个 链接 ， 单 击 它 将 显示 相应 主题 的 所 有 条 目 。 

1. URL 模 式 
显示 特定 主题 的 页 面 的 URL 模 式 与 前 面 的 所 有 URL 模 式 都 稍 有 不 同 ， 因 为 它 将 使 用 主题 的 id 
属性 来 指出 请 求 的 是 哪个 主题 。 例 如 ， 如 果 用 户 要 查看 主题 Chess ( 其 id 为 1 ) 的 详细 页 面 ，URL 
将 为 http://localhost:8000/topics/1/。 下 面 是 与 这 个 URL 匹 配 的 模式 , 它 包 含 在 learning logs/urls.py 中 : 


urls.py 


-- Ship-- 

urlpatterns 
-- Snip- 

# 特定 主题 的 详细 页 面 

url(r'^topics/(?P<topic id>\d+)/$', views.topic, name="'topic'), 


我 们 来 详细 研究 这 个 URL 模 式 中 的 正则 表达 式 一 一 r'^topics/(?P<topic_id>\d+)/$'。r 计 
Django 将 这 个 字符 串 视 为 原始 字符 串 , 并 指出 正则 表达 式 包含 在 引号 内 。 这 个 表达 式 的 第 二 部 分 
( /(?Px<topic id>\d+)/ ) 与 包含 在 两 个 斜 杠 内 的 整数 匹配 , 并 将 这 个 整数 存储 在 一 个 名 为 topic_id 
的 实 参 中 。 这 部 分 表达 式 两 边 的 括号 捕获 URL 中 的 值 ，?P<topic_id> 将 匹配 的 值 存储 到 topic_id 
中 ; 而 表达 式 \d+ 与 包含 在 两 个 斜 杆 内 的 任何 数字 都 匹配 ， 不 管 这 个 数字 为 多 少 位 。 

发 现 URL 与 这 个 模式 匹配 时 , Django 将 调用 视图 函数 topic(), 并 将 存储 在 topic id 中 的 值 作 
为 实 参 传递 给 它 。 在 这 个 函数 中 ， 我 们 将 使 用 topic_id 的 值 来 获取 相应 的 主题 。 

2. 视图 

函数 topic() 需 要 从 数据 库 中 获取 指定 的 主题 以 及 与 之 相关 联 的 所 有 条 目 ， 如 下 所 示 : 


views.py 


-- Snip-- 
@ def topic(request, topic id): 
"" "显示 单 个 主题 及 其 所 有 的 条 目 """ 
topic = Topic.objects.get(id=topic id) 
entries = topic.entry set.order by('-date added') 
context = {'topic': topic, 'entries': entries} 
return render(request, 'learning logs/topic.html', context) 


eaoe 


这 是 第 一 个 除 request 对 象 外 还 包含 另 一 个 形 参 的 视图 函数 。 这 个 函数 接受 正则 表达 式 
(?P<topic id>\d+) 捕 获 的 值 ， 并 将 其 存储 到 topic id 中 ( 见 @@ )。 在 @ 处 ， 我 们 使 用 get() 来 获取 
指定 的 主题 ， 就 像 前 面 在 Django shell 中 所 做 的 那样 。 在 @ 人 处， 我 们 获取 与 该 主题 相关 联 的 条 目 ， 
并 将 它们 按 date_added 排 序 : date_added 前 面 的 减 号 指定 按 降序 排列 ， 即 先 显示 最 近 的 条 目 。 我 
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们 将 主题 和 条 目 都 存储 在 字典 context 中 ( 见 @ )， 再 将 这 个 字典 发 送 给 模板 topichtml ( 见 @ )。 


注意 @ 处 和 @ 处 的 代码 被 称 为 查询 ， 因 为 它们 向 数据 库 查询 特定 的 信息 。 在 自己 的 项 目 中 编 
写 这 样 的 查询 时 ， 先 在 Django shell 中 进行 尝试 大 有 神 益 。 相 比 于 编写 视图 和 模板 ， 再 在 
浏览 器 中 检查 结果 ， 在 shell 中 执行 代码 可 更 快 地 获得 反馈 。 


3. 模板 
这 个 模板 需要 显示 主题 的 名 称 和 条 目的 内 容 ; 如 果 当 前 主题 不 包含 任何 条 目 , 我 们 还 需 向 用 
户 指出 这 一 点 : 


topic.html 


{% extends 'learning logs/base.html' %} 


{% block content %} 


© 


<p>Topic: {{ topic }}</p> 


<p>Entries:</p> 
<ul> 
{% for entry in entries %} 
<1i> 
<p>{{ entry.date added|date:'M d, Y H:i' }}</p> 
<p>{{ entry.text|linebreaks }}</p> 
</1i> 
{% empty %} 
<1i> 
There are no entries for this topic yet. 
</1i> 
{% endfor %} 
</ul> 


9 ee ee 


{% endblock content %} 


像 这 个 项 目的 其 他 页 面 一 样 , 这 里 也 继承 了 base.html。 接 下 来 , 我 们 显示 当前 的 主题 ( 见 @ )， 
它 存储 在 模板 变量 {{ topic }} 中 。 为 什么 可 以 使 用 变量 topic 呢 ”因为 它 包 含 在 字典 context 中 。 
接 下 来 ,我 们 开始 定义 一 个 显示 每 个 条 目的 项 目 列表 ( 见 @ )， 并 像 前 面 显示 所 有 主题 一 样 遍历 
条 目 ( 见 @ )。 
每 个 项 目 列表 项 都 将 列 出 两 项 信息 : 条 目的 时 间 戳 和 完整 的 文本 。 为 列 出 时 间 惟 ( 见 @ )， 
我 们 显示 属性 date_added 的 值 。 在 Django 模 板 中 ， 竖 线 ( | ) 表示 模板 过 滤器 -对 模板 变量 的 值 [1 
进行 修改 的 函数 。 过 滤器 date: 'M d，Y Hi: 让 以 这 样 的 格式 显示 时 间 惟 : January 1, 2015 23:00。 
接 下 来 的 一 行 显示 text 的 完整 值 ， 而 不 仅仅 是 entry 的 前 50 个 字符 。 过 滤器 linebreaks ( 见 @ ) 将 
包含 换行 符 的 长 条 目 转换 为 浏览 器 能 够 理解 的 格式 ， 以 免 显示 为 一 个 不 间断 的 文本 块 。 在 @ 处 ， 
我 们 使 用 模板 标签 {% empty %} 打 印 一 条 消息 ， 告 诉 用 户 当前 主题 还 没有 条 目 。 
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4. 将 显示 所 有 主题 的 页 面 中 的 每 个 主题 都 设置 为 链接 
在 浏览 器 中 查看 显示 特定 主题 的 页 面前 ,我 们 需要 修改 模板 topics.html， 让 每 个 主题 都 链接 
到 相应 的 网 页 ， 如 下 所 示 : 


topics.html 
-- Ship-- 
{% for topic in topics %} 
<1i> 
<a href="{% url 'learning logs:topic' topic.id %}">{{ topic }}</a> 
</1i> 
{% empty %} 
Ss Snip- 过 


我 们 使 用 模板 标签 url 根 据 learning_logs 中 名 为 topic 的 URL 模 式 来 生成 合适 的 链接 。 这 个 
URL 模 式 要 求 提 供 实 参 topic_ id， 因此 我 们 在 模板 标签 url 中 添加 了 属性 topic.id。 现在 ,主题 列 
表 中 的 每 个 主题 都 是 一 个 链接 ， 链 接 到 显示 相应 主题 的 页 面 ， 如 http://localhost:8000/topics/1/。 

如 果 你 刷新 显示 所 有 主题 的 页 面 , 再 单 击 其 中 的 一 个 主题 , 将 看 到 类 似 于 图 18-5 所 示 的 页 面 。 


localhost:8000/topics/1/- Chromium 
D localhost:8000/topics x 


@ DD localhost:8000/topics/1/ 字 三 


Learning Log - Topics 
Topic: Chess 
Entries: 

。 May 28, 2015 04:39 


In the opening phase of the game, it’s important to bring out your bishops and knights. These pieces are powerful and maneuverable enough to 
play a significant role in the beginning moves of a game. 


。 May 28, 2015 04:39 


The opening is the first part of the game, roughly the first ten moves or so. In the opening, it’s a good idea to do three things—bring out your 
bishops and knights, try to control the center of the board, and castle your king. 


Of course, these are just guidelines. It will be important to learn when to follow these guidelines and when to disregard these suggestions. 


图 18-5 ”特定 主题 的 详细 页 面 ， 其 中 显示 了 该 主题 的 所 有 条 目 


动手 试 一 斌 
18-7 模板 文档 : 请 浏览 Django 模板 文档 ， 其 网 址 为 https://docs.djangoproject.com/ 
en/1.8/ref/templates/。 自 己 开发 项 目 时 ， 可 再 回 过 头 来 参考 该 文档 。 
18-8 比萨 店 页 面 : 在 练习 18-6 中 开发 的 项 目 Pizzeria 中 添加 一 个 页 面 , 它 显 示 供 应 
示 一 个 页 


它 
的 比萨 的 名 称 。 然 后 ,将 每 个 比萨 名 称 都 设置 成 一 个 链接 ， 单 击 这 种 链接 将 显 
面 ， 其 中 列 出 了 相应 比萨 的 配料 。 请 务必 使 用 模板 继承 来 高 效 地 创建 页 面 。 
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18.5 小结 


在 本 章 中 ， 你 首先 学 习 了 如 何 使 用 Django 框 架 来 创建 Web 应 用 程序 。 你 制定 了 简要 的 项 目 规 
范 ,在 虚拟 环境 中 安装 了 Django， 创 建 了 一 个 项 目 ， 并 核实 该 项 目 已 正确 地 创建 。 你 学 习 了 如 何 
创建 应 用 程序 , 以 及 如 何 定义 表示 应 用 程序 数据 的 模型 。 你 学 习 了 数据 库 , 以 及 在 你 修改 模型 后 ， 
Django 可 为 你 迁移 数据 库 提供 什么 样 的 帮助 。 你 学 习 了 如 何 创建 可 访问 管理 网 站 的 超级 用 户 , 并 
使 用 管理 网 站 输入 了 一 些 初始 数据 。 

你 还 探索 了 Django shell, 它 让 你 能 够 在 终端 会 话 中 处 理 项 目的 数据 。 你 学 习 了 如 何 定义 URL、 
创建 视图 函数 以 及 编写 为 网 站 创建 网 页 的 模板 。 最 后 ， 你 使 用 了 模板 继承 ， 它 可 简化 各 个 模板 的 
结构 ， 并 使 得 修改 网 站 更 容易 。 

在 第 19 章 , 我 们 将 创建 对 用 户 友 好 而 直观 的 网 页 , 让 用 户 无 需 通过 管理 网 站 就 能 添加 新 的 主 
题 和 条 目 , 以 及 编辑 既 有 的 条 目 。 我 们 还 将 添加 一 个 用 户 注册 系统 ， 让 用 户 能 够 创建 账户 和 自己 
的 学 习 笔记 。 让 任意 数量 的 用 户 都 能 与 之 交互 ， 是 Web 应 用 程序 的 核心 所 在 。 


用 户 账 户 


Web 应 用 程序 的 核心 是 让 任何 用 户 都 能 够 注册 账户 并 能 够 使 用 
它 ， 不 管用 户 身 处 何方 。 在 本 章 中 ， 你 将 创建 一 些 表 单 ， 让 用 户 能 
够 添加 主题 和 条 目 ， 以 及 编辑 既 有 的 条 目 。 你 还 将 学 习 Django 如 何 
防范 对 基于 表单 的 网 页 发 起 的 常见 攻击 ， 这 让 你 无 需 花 太 多 时 间 考 
卡 确 保 应 用 程序 安全 的 问题 。 

然后 ， 我 们 将 实现 一 个 用 户 身份 验证 系统 。 你 将 创建 一 个 注册 
页 面 ， 供 用 户 创建 账户 ， 并 让 有 些 页 面 只 能 供 已 登录 的 用 户 访问 。 
接 下 来 , 我 们 将 修改 一 些 视 图 函数 ,使 得 用 户 只 能 看 到 自己 的 数据 。 
你 将 学 习 如 何 确保 用 户 数据 的 安全 。 


19.1 让 用 户 能 够 输入 数据 


建立 用 于 创建 用 户 账户 的 身份 验证 系统 之 前 , 我们 先 来 添加 儿 个 页 面 ,让 用 户 能 够 输入 数据 。 
我 们 将 让 用 户 能 够 添加 新 主题 、 添 加 新 条 目 以 及 编辑 既 有 条 目 。 

当前 ， 只 有 超级 用 户 能 够 通过 管理 网 站 输入 数据 。 我 们 不 想 让 用 户 与 管理 网 站 交互 ， 因 此 我 
们 将 使 用 Django 的 表单 创建 工具 来 创建 让 用 户 能 够 输入 数据 的 页 面 。 


19.1.1 添加 新 主题 


首先 来 让 用 户 能 够 添加 新 主题 。 创建 基于 表单 的 页 面 的 方法 几乎 与 前 面 创建 网 页 一 样 : 定义 
一 个 URL ， 编 写 一 个 视图 函数 并 编写 一 个 模板 。 一 个 主要 差别 是 ， 需 要 导 和 人 包含 表单 的 模块 
forms.py。 

1. 用 于 添加 主题 的 表单 

让 用 户 输入 并 提交 信息 的 页 面 都 是 表单 , 那 怕 它 看 起 来 不 像 表 单 。 用 户 输入 信息 时 , 我们 需 
要 进行 验证 , 确认 提供 的 信息 是 正确 的 数据 类 型 ， 且 不 是 恶意 的 信息 ， 如 中 断 服务 器 的 代码 。 然 
后 ， 我 们 再 对 这 些 有 效 信息 进行 处 理 ， 并 将 其 保存 到 数据 库 的 合适 地 方 。 这 些 工作 很 多 都 是 由 
Django 自动 完成 的 。 
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在 Django 中 ,创建 表单 的 最 简单 方式 是 使 用 ModelForm， 它 根据 我 们 在 第 18 章 定义 的 模型 中 
的 信息 自动 创建 表单 。 创 建 一 个 名 为 forms.py 的 文件 ， 将 其 存储 到 models.py 所 在 的 目录 中 ， 并 在 
其 中 编写 你 的 第 一 个 表单 : 


forms.py 


from django import forms 
from .models import Topic 


@ class TopicForm(forms.ModelForm): 


class Meta: 
2 model = Topic 
(3 fields = ['text'] 
@ labels = {'text': ''} 


我 们 首先 导入 了 模块 forms 以 及 要 使 用 的 模型 Topic。 在 @ 人 处 , 我 们 定义 了 一 个 名 为 TopicForm 
的 类 ， 它 继承 了 forms .ModelForm。 

最 简单 的 ModelForm 版 本 只 包含 一 个 内 机 的 Meta 类 , 它 告诉 Django 根 据 哪个 模型 创建 表单 ， 以 
及 在 表单 中 包含 哪些 字段 。 在 @ 处 ， 我 们 根据 模型 Topic 创 建 一 个 表单 ， 该 表单 只 包含 字段 text 
( 见 @ )。@ 处 的 代码 让 Django 不 要 为 字段 text 生 成 标签 。 

2. URL 模 式 new topic 

这 个 新 网 页 的 URL 应 简短 而 具有 描述 性 ， 因 此 当 用 户 要 添加 新 主题 时 ， 我 们 将 切换 到 
http://localhost:8000/mew_topic/。 下面 是 网 页 new_topic 的 URL 模 式 , 我 们 将 其 添加 到 learning logs/ 
urls.py 中 : 


urls.py 


-- Ship-- 
urlpatterns = [ 
-- Snip-- 
# 用 于 添加 新 主题 的 网 页 
url(r'^new topic/$', views.new topic，name= 'new topic'), 


] 
这 个 URL 模 式 将 请 求 交 给 视图 函数 new_topic()， 接 下 来 我 们 将 编写 这 个 函数 。 
3. 视图 函数 new_topic() 
函数 new topic() 需 要 处 理 两 种 情形 : 刚 进 入 new topic 网 页 (在 这 种 情况 下 ， 它 应 显示 一 个 
空 表单 ); 对 提交 的 表单 数据 进行 处 理 ， 并 将 用 户 重 定向 到 网 页 topics: 
views.py 
from django.shortcuts import render | 
from django.http import HttpResponseRedirect 


from django.core.urlresolvers import reverse 
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from .models import Topic 
from .forms import TopicForm 


-- Snip-- 
def new topic(request): 
"" "添加 新 主题 """ 
if request.method != 'POST': 
# 未 提交 数据 : 创建 一 个 新 表单 
form = TopicForm() 
else: 
# POST 提交 的 数据 ,对 数据 进行 处 理 
form = TopicForm(Tequest.POST) 
if form.is valid(): 
form. save() 
return HttpResponseRedirect(reverse('learning logs:topics')) 


© 


® 


@ 9ooeoao 


context = {'form': form} 
return render(request, 'learning logs/new topic.html', context) 


我 们 导入 了 HttpResponseRedirect 类 ， 用 户 提 交 主 题 后 我 们 将 使 用 这 个 类 将 用 户 重 定向 到 网 
页 topics。 消 数 reverse() 根 据 指定 的 URL 模 型 确定 URL, 这 意味 着 Django 将 在 页 面 被 请 求 时 生成 
URL。 我 们 还 导入 了 刚才 创建 的 表单 TopicForm。 

4. GET 请 求 和 POST 请 求 

创建 Web 应 用 程序 时 ， 将 用 到 的 两 种 主要 请 求 类 型 是 GET 请 求 和 POST 请 求 。 对 于 只 是 从 服务 
器 读 取 数 据 的 页 面 ， 使 用 GET 请 求 ; 在 用 户 需要 通过 表单 提交 信息 时 ,通常 使 用 POST 请 求 。 处 理 
所 有 表单 时 ， 我 们 都 将 指定 使 用 POST 方法 。 还 有 一 些 其 他 类 型 的 请 求 ， 但 这 个 项 目 没有 使 用 。 

函数 new_topic() 将 请 求 对 象 作为 参数 。 用 户 初次 请 求 该 网 页 时 ， 其 浏览 器 将 发 送 GET 请 求 ; 
用 户 填 写 并 提交 表单 时 ， 其 浏览 器 将 发 送 POST 请 求 。 根 据 请 求 的 类 型 ， 我 们 可 以 确定 用 户 请 求 
的 是 空 表 单 ( GET 请 求 ) 还 是 要 求 对 填写 好 的 表单 进行 处 理 ( POST 请 求 )。 

@ 处 的 测试 确定 请 求 方法 是 GET 还 是 POST。 如 果 请 求 方法 不 是 POST， 请 求 就 可 能 是 GET， 
此 我 们 需要 返回 一 个 空 表单 ( 即便 请 求 是 其 他 类 型 的 ， 返 回 一 个 空 表单 也 不 会 有 任何 问题 )。 
我 们 创建 一 个 TopicForm 实 例 ( 见 @ )， 将 其 存储 在 变量 form 中 ， 再 通过 上 下 文字 典 将 这 个 表单 发 
送 给 模板 ( 见 @ )。 由 于 实例 化 TopicForm 时 我 们 没有 指定 任何 实 参 ，Django 将 创建 一 个 可 供用 户 
填写 的 空 表单 。 

如 果 请 求 方法 为 POST， 将 执行 else 代 码 块 ， 对 提交 的 表单 数据 进行 处 理 。 我 们 使 用 用 户 输 
入 的 数据 (它们 存储 在 request.P0ST 中 ) 创建 一 个 TopicForm 实 例 ( 见 @ )， 这 样 对 象 form 将 包含 
用 户 提交 的 信息 。 

要 将 提交 的 信息 保存 到 数据 库 ， 必 须 先 通过 检查 确定 它们 是 有 效 的 ( 见 @ )。 函 数 is_valid() 
核实 用 户 填写 了 所 有 必 不 可 少 的 字段 (表单 字段 默认 都 是 必 不 可 少 的 )， 且 输入 的 数据 与 要 求 的 
字段 类 型 一 致 (例如 ,字段 text 少 于 200 个 字符 ,这 是 我 们 在 第 18 章 中 的 models.py 中 指定 的 )。 这 
种 自动 验证 避免 了 我 们 去 做 大 量 的 工作 。 如 果 所 有 字段 都 有 效 ， 我 们 就 可 调用 save() ( 见 @ )， 
将 表单 中 的 数据 写 人 数据 库 。 保 存 数 据 后 ， 就 可 离开 这 个 页 面 了 。 我 们 使 用 reverse() 获 取 页 面 
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topics 的 URL， 并 将 其 传递 给 HttpResponseRedirect() ( 见 @ )， 后 者 将 用 户 的 浏览 器 重 定向 到 页 
面 topics。 在 页 面 topics 中 ， 用 户 将 在 主题 列表 中 看 到 他 刚 输入 的 主题 。 

5. 模板 new_topic 

下 面 来 创建 新 模板 new_topic.html， 用 于 显示 我 们 刚 创 建 的 表单 : 


new_topic.html 


{% extends "learning logs/base.html" %} 


{% block content %} 
<p>Add a new topic:</p> 


<form action="{% url 'learning logs:new topic' %}" method='post'> 
{% csrf token %} 
{{ form.as p }} 
<button name="submit">add topic</button> 

</form> 


OO 


{% endblock content %} 


这 个 模板 继承 了 base.html， 因 此 其 基本 结构 与 项 目 “ 学 习 笔 记 ” 的 其 他 页 面相 同 。 在 @ 处 ， 
我 们 定义 了 一 个 HTML 表 单 。 实 参 action 告 诉 服务 器 将 提交 的 表单 数据 发 送 到 哪里 ， 这 里 我 们 将 
它 发 回 给 视图 函数 new_topic()。 实 参 method 让 浏览 器 以 POST 请 求 的 方式 提交 数据 。 

Django 使 用 模板 标签 {% csrf_token %}( 见 @ ) 来 防止 攻击 者 利用 表单 来 获得 对 服务 器 未 经 
授权 的 访问 〈 这 种 攻击 被 称 为 跨 站 请 求 伪 造 )。 在 @ 处 ,我 们 显示 表单 ， 从 中 可 知 Django 使 得 完 
成 显示 表单 等 任务 有 多 简单 :我们 只 需 包含 模板 变量 {{ form.as_p }}， 就 可 让 Django 自 动 创建 显 
示 表 单 所 需 的 全 部 字段 。 修 饰 符 as_p 让 Django 以 段落 格式 泻 染 所 有 表单 元 素 ， 这 是 一 种 整洁 地 显 
示 表 单 的 简单 方式 。 

Django 不 会 为 表单 创建 提交 按钮 ， 因 此 我 们 在 @ 处 定义 了 一 个 这 样 的 按钮 。 

6. 链接 到 页 面 new_topic 

接 下 来 ,我 们 在 页 面 topics 中 添加 一 个 到 页 面 new_topic 的 链接 : 


=. 


topics.html 


{% extends "learning logs/base.html" %} 
{% block content %} 

<p>Topics</p> 

<U]> 


--5170D-- 
</U]> 


<a href="{% url 'learning logs:new topic' %}">Add a new topic:</a> 


{% endblock content %} 
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这 个 链接 放 在 了 既 有 主题 列表 的 后 面 。 图 19-1 显 示 了 生成 的 表单 。 请 使 用 这 个 表单 来 添加 几 
个 新 主题 。 


localhost:8000/new_topic/ - Chromium 


DD localhost:8000/new_ x 
、 @ | BD localhost:8000/new_topic/ oo 


Learning Log - Topics 


Add a new topic: 


| add topic | 


图 19-1 用 于 添加 新 主题 的 页 面 


19.1.2 ”添加 新 条 目 

现在 用 户 可 以 添加 新 主题 了 , 但 他 们 还 想 添加 新 条 目 。 我 们 将 再 次 定义 URL, 编写 视图 函数 
和 模板 ， 并 链接 到 添加 新 条 目的 网 页 。 但 在 此 之 前 ， 我 们 需要 在 forms.py 中 再 添加 一 个 类 。 

1. 用 于 添加 新 条 目的 表单 

我 们 需要 创建 一 个 与 模型 Entry 相 关联 的 表单 ， 但 这 个 表单 的 定制 程度 比 TopicForm 要 高 些 : 


forms.py 


from django import forms 
from .models import Topic, Entry 


class TopicForm(forms.ModelForm): 
-- Snip-- 


class EntryForm(forms.ModelForm): 
class Meta: 
model = Entry 
fields = ['text'] 
© labels = {'text': ''} 
(29 widgets = {'text': forms.Textarea(attrs={'cols': 80})} 


我 们 首先 修改 了 ;import 语 句 ， 使 其 除 导 入 Topic 外 ， 还 导入 Entry。 新 类 EntryForm 继 承 了 
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forms .ModelForm, 它 包含 的 Meta 类 指出 了 表单 基于 的 模型 以 及 要 在 表单 中 包含 哪些 字段 。 这 里 也 
给 字段 'text' 指 定 了 一 个 空 标签 ( 见 @ )。 

在 @ 人 处 , 我 们 定义 了 属性 widgets。 小 部 件 ( widget ) 是 一 个 HTML 表 单元 素 ， 如 单行 文本 框 、 
多 行文 本 区 域 或 下 拉 列 表 。 通 过 设置 属性 widgets， 可 覆盖 Django 选 择 的 默认 小 部 件 。 通 过 让 
Django 使 用 forms.Textarea， 我 们 定制 了 字段 'text ' 的 输入 小 部 件 ， 将 文本 区 域 的 宽度 设置 为 80 
列 ， 而 不 是 默认 的 40 列 。 这 给 用 户 提 供 了 足够 的 空间 ， 可 以 编写 有 意义 的 条 目 。 

2. URL 模 式 new_entry 

在 用 于 添加 新 条 目的 页 面 的 URL 模 式 中 ,需要 包含 实 参 topic_id， 因 为 条 目 必 须 与 特定 的 主 
题 相 关联 。 该 URL 模 式 如 下 ， 我 们 将 它 添加 到 了 learning_logs/urls.py 中 : 


urls.py 


-- SNip-- 
urlpatterns = [ 
-- Ship-- 
# 用 于 添加 新 条 目的 页 面 
url(r'^new entry/(?P<topic id>\d+)/$', views.new entry, name='new entry'), 


] 


这 个 URL 模 式 与 形式 为 http://localhost:8000/new entry/id/ 的 URL 匹 配 ， 其 中 i4 是 一 个 与 
主题 ID 匹 配 的 数字 。 代 码 (?P<topic_id>\d+) 捕 获 一 个 数字 值 ， 并 将 其 存储 在 变量 topic_ id 中 。 请 
求 的 URL 与 这 个 模式 匹配 时 ，Dijango 将 请 求 和 主题 ID 发 送 给 函数 new_entry()。 

3. 视图 函数 new_entry() 

视图 函数 new_entry() 与 函数 new_topic() 很 像 : 


views.py 

from django.shortcuts import render 
-- SNip-- 

from .models import Topic 


from .forms import TopicForm, EntryForm 


--Snip-- 
def new entry(request, topic id): 

""" 在 特定 的 主题 中 添加 新 条 目 """ 

topic = Topic.objects.get(id=topic id) 


© if request.method != 'POST': 
# 未 提交 数据 ,创建 一 个 空 表 单 


(3 form = EntryForm() 
else: 
# POST 提交 的 数据 ,对 数据 进行 处 理 
@ form = EntryForm(data=request.POST) 


if form.is valid(): 
new entry = form.save(commit=False) 
new entry.topic = topic 


9g 
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new_entry.save() 
@ return HttpResponseRedirect(reverse('learning logs:topic', 
args=[topic id])) 


context = {'topic': topic, 'form': form} 
return render(request, 'learning logs/new entry.html', context) 


我 们 修改 了 import 语 句 ， 在 其 中 包含 了 刚 创 建 的 EntryForm。new_entry() 的 定义 包含 形 参 
topic_id， 用 于 存储 从 URL 中 获得 的 值 。 演 染 页 面 以 及 处 理 表 单数 据 时 ， 都 需要 知道 针对 的 是 哪 
个 主题 ， 因 此 我 们 使 用 topic id 来 获得 正确 的 主题 ( 见 @ )。 

在 @ 处 ,我 们 检查 请 求 方法 是 POST 还 是 GET。 如 果 是 GET 请 求 ， 将 执行 if 代 码 块 : 创建 一 
个 空 的 EntryForm 实 例 ( 见 @ )。 如 果 请 求 方法 为 POST , 我们 就 对 数据 进行 处 理 : 创建 一 个 EntryForm 
实例 , 使 用 request 对 象 中 的 POST 数据 来 填充 它 ( 见 @ ); 再 检查 表单 是 否 有 效 ， 如 果 有 效 ， 就 设 
置 条 目 对 象 的 属性 topic， 再 将 条 目 对 象 保存 到 数据 库 。 

调用 save() 时 ， 我 们 传递 了 实 参 commit=False ( 见 日 )， 让 Dijango 创 建 一 个 新 的 条 目 对 象 ， 并 
将 其 存储 到 new_entry 中 , 但 不 将 它 保 存 到 数据 库 中 。 我 们 将 new_entry 的 属性 topic 设 置 为 在 这 个 
函数 开头 从 数据 库 中 获取 的 主题 ( 见 @ )， 然 后 调用 save() ， 且 不 指定 任何 实 参 。 这 将 把 条 目 保 
存 到 数据 库 ， 并 将 其 与 正确 的 主题 相关 联 。 

在 @ 处 ， 我 们 将 用 户 重 定向 到 显示 相关 主题 的 页 面 。 调 用 reverse() 时 ， 需 要 提供 两 个 实 参 : 
要 根据 它 来 生成 URL 的 URL 模 式 的 名 称 ; 列表 args， 其 中 包含 要 包含 在 URL 中 的 所 有 实 参 。 在 这 
里 , 列表 args 只 有 一 个 元 素 topic id。 接 下 来 , 调用 HttpResponseRedirect() 将 用 户 重 定向 到 
显示 新 增 条 目 所 属 主题 的 页 面 ， 用 户 将 在 该 页 面 的 条 目 列表 中 看 到 新 添加 的 条 目 。 

4. 模板 new_entry 

从 下 面 的 代码 可 知 ， 模 板 new_entry 类 似 于 模板 new_topic: 


de 


new_entry.html 


{% extends "learning logs/base.html" %} 
{% block content %} 
@ “pa href="{% url 'learning logs:topic' topic.id %}">{{ topic }}</a></p> 


<p>Add a new entry:</p> 
@ <form action="{% url 'learning logs:new entry' topic.id %}" method="'post'> 
{% csrf token %} 
{{ form.as p }} 
<button name="'submit'>add entry</button> 
</form> 


{% endblock content %} 


我 们 在 页 面 顶端 显示 了 主题 ( 见 @ )， 让 用 户 知道 他 是 在 哪个 主题 中 添加 条 目 ; 该 主题 名 也 
是 一 个 链接 ， 可 用 于 返回 到 该 主题 的 主页 面 。 
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表单 的 实 参 action 包 含 URL 中 的 topic id 值 ,让 视图 函数 能 够 将 新 条 目 关 联 到 正确 的 主题 ( 见 
@ )。 除 此 之 外 ， 这 个 模板 与 模板 new_topic.html 完 全 相同 。 
5. 链接 到 页 面 new_entry 


接 下 来 ， 我们 需要 在 显示 特定 主题 的 页 面 中 添加 到 页 面 new_entry 的 链接 : 
topic.html 


{% extends "learning logs/base.html" %} 
{% block content %} 
<p>Topic: {{ topic }}</p> 


<p>Entries:</p> 


<p> 
<a href="{% url 'learning logs:new entry' topic.id %}">add new entry</a> 
</p> 
<ul> 
-- Snip 
</ul> 


{% endblock content %} 


我 们 在 显示 条 目前 添加 链接 , 因为 在 这 种 页 面 中 ,执行 的 最 常见 的 操作 是 添加 新 条 目 。 图 19-2 
显示 了 页 面 new_entry。 现 在 用 户 可 以 添加 新 主题 ， 还 可 以 在 每 个 主题 中 添加 任意 数量 的 条 目 。 
请 在 一 些 既 有 主题 中 添加 一 些 新 条 目 ， 尝 试 使 用 一 下 页 面 new_entry。 


localhost:8000/new_entry/1/- Chromium 


癌 localhost:8000/new_¢ x 


@ | localhost:8000/new_entry/1/ 


Learning Log - Topics 
Chess 


Add a new entry: 


The bishops and knights are good pieces to have out in the opening phase of the 
game. They're both powerful enough to be useful in attacking your opponent, but 
not so powerful that you can't afford to lose them in an early trade. 


图 19-2 ”页 面 new_entry 
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19.1.3 ”编辑 条 目 


下 面 来 创建 一 个 页 面 ， 让 用 户 能 够 编辑 既 有 的 条 目 。 
1. URL 模 式 edit_entry 
这 个 页 面 的 URL 需 要 传递 要 编辑 的 条 目的 ID。 修 改 后 的 learning_logs/urls.py 如 下 : 


urls.py 


=- Ship-- 
urlpatterns 
-- Snip-- 
# 用 于 编辑 条 目的 页 面 
url(r'^edit entry/(?P<entry id>\d+)/$', views.edit entry, 
name="edit_ entry'), 
] 


在 URL ( 如 http://localhost:8000/edit_entry/1/ ) 中 传递 的 人 D 存 储 在 形 参 entry id 中。 这 个 URL 
模式 将 预期 匹配 的 请 求 发 送 给 视图 函数 edit_entry()。 

2. 视图 函数 edit_entry() 

页 面 edit_entry 收 到 GET 请 求 时 ，edit_entry() 将 返回 一 个 表单 ， 让 用 户 能 够 对 条 目 进行 纺 
辑 。 该 页 面 收 到 POST 请 求 (条目 文本 经 过 修订 ) 时 ， 它 将 修改 后 的 文本 保存 到 数据 库 中 : 


views.py 


rom django.shortcuts import render 


-- SN1p-- 


from .models import Topic, Entry 
rom .forms import TopicForm, EntryForm 


--SNip-- 


def edit entry(request, entry id): 
"编辑 既 有 条 目 """ 

© entry = Entry.objects.get(id=entry id) 

topic = entry.topic 


if request.method != "POST': 
# 初次 请 求 ， 使 用 当前 条 目 填充 表单 
@ form = EntryForm(instance=entry) 
else: 
# POST 提交 的 数据 ， 对 数据 进行 处 理 
(3 form = EntryForm(instance=entry, data=request.POST) 
if form.is valid(): 
form. save() 
return HttpResponseRedirect(reverse('learning logs:topic', 
args=[topic.id])) 


@e 


context = {'entry': entry, 'topic': topic, 'form': form} 
return render(request, 'learning logs/edit entry.html', context) 
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我 们 首先 需要 导入 模型 Entry。 在 @ 处 ,我们 获取 用 户 要 修改 的 条 目 对 象 ， 以 及 与 该 条 目 相 
关联 的 主题 。 在 请 求 方法 为 GET 时 将 执行 的 if 代 码 块 中 ， 我 们 使 用 实 参 instance=entry 创 建 一 个 
EntryForm 实 例 ( 见 @ )。 这 个 实 参 让 Django 创 建 一 个 表单 ,并 使 用 既 有 条 目 对 象 中 的 信息 填充 它 。 
用 户 将 看 到 既 有 的 数据 ， 并 能 够 编辑 它们 。 

处 理 POST 请 求 时 ， 我 们 传递 实 参 instance=entry 和 data=request.P0ST ( 见 @ )， 让 Django 根 
据 既 有 条 目 对 象 创建 一 个 表单 实例 ， 并 根据 request.P0ST 中 的 相关 数据 对 其 进行 修改 。 然 后 ， 我 
们 检查 表单 是 否 有 效 ， 如 果 有 效 ， 就 调用 save() ， 且 不 指定 任何 实 参 ( 见 @ )。 接 下 来 ， 我 们 重 
定向 到 显示 条 目 所 属 主 题 的 页 面 ( 见 @ )， 用 户 将 在 其 中 看 到 其 编辑 的 条 目的 新 版 本 。 

3. 模板 edit_entry 

下 面 是 模板 edit_entry.html， 它 与 模板 new_entry.html 类 似 : 


edit_entry.html 


{% extends "learning logs/base.html" %} 

{% block content %} 
<p><a href="{% url 'learning logs:topic' topic.id %}">{{ topic }}</a></p> 
<p>Edit entry:</p> 


@ “form action="{% url 'learning logs:edit entry' entry.id %}" method="'post'> 
{% csrf token %} 
{{ form.as p }} 
2 <button name="submit">save changes</button> 
</form> 


{% endblock content %} 


在 @ 处 ， 实 参 action 将 表单 发 回 给 函数 edit_entry() 进 行 处 理 。 在 标签 {% url %} 中 ， 我 们 将 
条 目 ID 作为 一 个 实 参 ， 让 视图 对 象 能 够 修改 正确 的 条 目 对 象 。 我 们 将 提交 按钮 命名 为 save 
changes， 以 提醒 用 户 : 单 击 该 按钮 将 保存 所 做 的 编辑 ， 而 不 是 创建 一 个 新 条 目 ( 见 @ )。 

4. 链接 到 页 面 edit_entry 

现在 ， 在 显示 特定 主题 的 页 面 中 ， 需 要 给 每 个 条 目 添加 到 页 面 edit_entry 的 链接 : 


topic.html 


-- Snip-- 
{% for entry in entries %} 
<]i> 
<p>{{ entry.date added|date:'M d, Y H:i' }}</p> 
<p>{{ entry.text|linebreaks }}</p> 
<p> 
<a href="{% url 'learning logs:edit entry' entry.id %}">edit entry</a> 
</p> 
</1i> 
-- Snip-- 
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我 们 将 编辑 链接 放 在 每 个 条 目的 日 期 和 文本 后 面 。 在 循环 中 ， 我 们 使 用 模板 标签 {% url %} 
根据 URL 模 式 edit_entry 和 当前 条 目的 ID 属性 ( entry.id 羡 确 定 URL ,链接 文本 为 "edit entry"， 
它 出 现在 页 面 中 每 个 条 目的 后 面 。 图 19-3 显 示 了 包含 这 些 链接 时 ， 显 示 特 定 主题 的 页 面 是 什么 
样 的 。 


localhost:8000/topics/1/- chromium 


D localhost:8000/topics x 
和 © |B localhost:8000/topics/1/ 


站 
咱 


Learning Log - Topics 和 
Topic: Chess 
Entries: 
add new entry 
。 Jun 12, 2015 15:30 
The bishops and knights are good pieces to have out in the opening phase of the game. They're both powerful 


enough to be useful in attacking your opponent, but not so powerful that you can't afford to lose them in an early 
trade. 


edit entry 
。 May 28, 2015 04:39 


In the opening phase of the game, it’s important to bring out your bishops and knights. These pieces are powerful — 
and maneuverable enough to play a significant role in the beginning moves of a game. 


edit entry 
。 May 28, 2015 04:39 


图 19-3 ”每 个 条 目 都 有 一 个 用 于 对 其 进行 编辑 的 链接 
至 此 ,“ 学 习 笔记 ”已 具备 了 需要 的 大 部 分 功能 。 用 户 可 添加 主题 和 条 目 ， 还 可 根据 需要 查 


看 任何 一 组 条 目 。 在 下 一 他， 我们 将 实现 一 个 用 户 注册 系统 ,让 任何 人 都 可 向 “学 习 笔 记 ” 申 请 
账户 ， 并 创建 自己 的 主题 和 条 目 。 


动手 试 一 试 
19-1 博客 : 新 建 一 个 Django 项 目 ， 将 其 命名 为 Blog。 在 这 个 项 目 中 ,创建 一 个 名 
为 blogs 的 应 用 程序 ,并 在 其 中 创建 一 个 名 为 BlogPost 的 模型 。 这 个 模型 应 包含 title、 


text 和 date added 等 字段 。 为 这 个 项 目 创建 一 个 超级 用 户 ， 并 使 用 管理 网 站 创建 几 个 
简短 的 帖子 。 创 建 一 个 主页 ， 在 其 中 按时 间 顺 序 显示 所 有 的 帖子 。 

创建 两 个 表单 ， 其 中 一 个 用 于 发 布 新 帖子 ， 另 一 个 用 于 编辑 既 有 的 帖子 。 

尝试 填写 这 些 表单 ， 确 认 它 们 能 够 正确 地 工作 。 


19.2 ”创建 用 户 账户 
在 这 一 节 , 我 们 将 建立 一 个 用 户 注册 和 身份 验证 系统 ， 让 用 户 能 够 注册 账户 ,进而 登录 和 注 
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销 。 我 们 将 创建 一 个 新 的 应 用 程序 ,其 中 包含 与 处 理 用 户 账户 相关 的 所 有 功能 。 我 们 还 将 对 模型 
Topic 稍 做 修改 ， 让 每 个 主题 都 归属 于 特定 用 户 。 


19.2.1 应 用 程序 users 
我 们 首先 使 用 命令 startapp 来 创建 一 个 名 为 users 的 应 用 程序 : 


(11 env)learning log$ python manage.py startapp users 
(11 env)learning log$ ls 

@ db.sqlite3 learning log learning logs ll env manage.py users 
(11 env)learning log$ ls users 

@ admin.py _init .py migrations models.py tests.py views.py 


这 个 命令 新 建 一 个 名 为 users 的 目录 ( 见 @ )， 其 结构 与 应 用 程序 learning_ logs 相 同 ( 见 @ )。 
1. 将 应 用 程序 users 添 加 到 settings.py 中 
在 settings.py 中 ， 我 们 需要 将 这 个 新 的 应 用 程序 添加 到 INSTALLED_APPS 中 ， 如 下 所 示 : 


settings.py 


-- SNip-- 

INSTALLED APPS = ( 
-- Ship-- 
# 我 的 应 用 程序 
'learning logs', 
'Users', 


-- SNip-- 


这 样 ，Django 将 把 应 用 程序 users 包 含 到 项 目 中 。 
2. 包含 应 用 程序 users 的 URL 
接 下 来 ,我 们 需要 修改 项 目 根 目录 中 的 urls.py ,使 其 包含 我 们 将 为 应 用 程序 users 定 义 的 URL: 


urls.py 


from django.conf.urls import include, url 
from django.contrib import admin 


urlpatterns = [ 
url(r'^admin/', include(admin.site.urls)), 
url(r'^users/', include('users.urls', namespace="'Users')), 
url(r'', include('learning logs.urls', namespace='learning logs')), 


] 


我 们 添加 了 一 行 代 码 ， 以 包含 应 用 程序 users 中 的 文件 urls.py。 这 行 代 码 与 任何 以 单词 users 
打头 的 URL ( 如 http://localhost:8000/users/login/ ) 都 匹配 。 我 们 还 创建 了 命名 空间 'users' ， 以 便 
将 应 用 程序 learning logs 的 URL 同 应 用 程序 users 的 URL 区 分 开 来 。 
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19.2.2 ”登录 页 面 


我 们 首先 来 实现 登录 页 面 的 功能 。 为 此 , 我们 将 使 用 Django 提 供 的 默认 登录 视图 ， 因 此 URL 
模式 会 稍 有 不 同 。 在 目录 learning log/users/ 中 ， 新 建 一 个 名 为 urls.py 的 文件 ， 并 在 其 中 添加 如 下 
代码 : 

urls.py 


mu 为 应 用 程序 Users 定 义 URL 模 式 """ 


from django.conf.urls import url 
@ from django.contrib.auth.views import login 


from . import views 


urlpatterns = [ 
# 登录 页 面 
[29 url(r'^login/$', login, {'template name': 'users/login.html'}, 
name=" login'), 
] 


我 们 首先 导入 了 默认 视图 login ( 见 @ )。 登 录 页 面 的 URL 模 式 与 URL http://localhost:8000/ 
users/login/ 匹 配 ( 见 @ )。 这 个 UREL 中 的 单词 users 让 Django 在 users/urls.py 中 查找 ， 而 单词 login 让 
它 将 请 求 发 送 给 Django 默 认 视 图 login (请 注意 ， 视 图 实 参 为 login， 而 不 是 views .1login )。 鉴 于 
我 们 没有 编写 自己 的 视图 函数 ,我 们 传递 了 一 个 字典 , 告诉 Django 去 哪里 查找 我 们 将 编写 的 模板 。 
这 个 模板 包含 在 应 用 程序 users 而 不 是 learning logs 中 。 

1. 模板 login.html 
用 户 请 求 登录 页 面 时 ，Django 将 使 用 其 默认 视图 login， 但 我 们 依然 需要 为 这 个 页 面 提供 模 
板 。 为 此 ， 在 目录 learning log/users/ 中 ， 创 建 一 个 名 为 templates 的 目录 ， 并 在 其 中 创建 一 个 名 为 
users 的 目录 。 以 下 是 模板 login.html， 你 应 将 其 存储 到 目录 learning log/users/templates/users/ 中 : 


login.html 


{% extends "learning logs/base.html" %} 
{% block content %} 


@ {% if form.errors %} 
<p>Your username and password didn't match. Please try again.</p> 
{% endif %} 


<form method="post" action="{% url] 'users:login' %}"> 
{% csrf token %} 
{{ form.as p }} 


ee © © 


<button name="submit">log in</button> 
<input type="hidden" name="next" value="{% url 'learning logs:index' %}" /> 
</form> 
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{% endblock content %} 


这 个 模板 继承 了 base.html， 则 在 确保 登录 页 面 的 外 观 与 网 站 的 其 他 页 面相 同 。 请 注意 , 一 个 
应 用 程序 中 的 模板 可 继承 男 一 个 应 用 程序 中 的 模板 。 

如 果 表 单 的 errors 属 性 被 设置 ， 我 们 就 显示 一 条 错误 消息 ( 见 @ )， 指 出 输入 的 用 户 名 -密码 
对 与 数据 库 中 存储 的 任何 用 户 名 -密码 对 都 不 匹配 。 

我 们 要 让 登录 视图 处 理 表 单 ， 因 此 将 实 参 action 设 置 为 登录 页 面 的 URL ( 见 @ )。 登 录 视 图 
将 一 个 表单 发 送 给 模板 ， 在 模板 中 ， 我 们 显示 这 个 表单 ( 见 @ ) 并 添加 一 个 提交 按钮 ( 见 @ )。 
在 @ 处 , 我 们 包含 了 一 个 隐藏 的 表单 元 素 一 'next', 其 中 的 实 参 value 告 诉 Django 在 用 户 成 功 登 
录 后 将 其 重 定向 到 什么 地 方 一 一 在 这 里 是 主页 。 

2. 链接 到 登录 页 面 

下 面 在 base.html 中 添加 到 登录 页 面 的 链接 ， 让 所 有 页 面 都 包含 它 。 用 户 已 登录 时 ,我 们 不 想 
显示 这 个 链接 ， 因 此 将 它 舰 套 在 一 个 {% if %} 标 签 中 : 


base.html 


<p> 
<a href="{% url 'learning logs:index' %}">Learning Log</a> - 
<a href="{% url 'learning logs:topics' %}">Topics</a> - 


@ {% if user.is authenticated %} 
© Hello, {{ user.username }}. 
{% else %} 
3 <a href="{% url 'users:login' %}">log in</ay> 
{% endif %} 
</p> 


{% block content %}{% endblock content %} 


在 Django 身 份 验 证 系统 中 ， 每 个 模板 都 可 使 用 变量 user， 这 个 变量 有 一 个 is_authenticated 
属性 : 如 果 用 户 已 登录 ,该 属性 将 为 True， 否 则 为 False。 这 让 你 能 够 向 已 通过 身份 验证 的 用 户 
显示 一 条 消息 ， 而 向 未 通过 身份 验证 的 用 户 显 示 另 一 条 消息 。 

在 这 里 ， 我 们 向 已 登录 的 用 户 显示 一 条 问候 语 ( 见 @ )。 对 于 已 通过 身份 验证 的 用 户 ， 还 设 
置 了 属性 username， 我 们 使 用 这 个 属性 来 个 性 化 问候 语 ， 让 用 户 知道 他 已 登录 ( 见 @ )。 在 @@ 处 ， 
对 于 还 未 通过 身份 验证 的 用 户 ， 我们 再 显示 一 个 到 登录 页 面 的 链接 。 

3. 使 用 登录 页 面 

前 面 建立 了 一 个 用 户 账户 ， 下 面 来 登录 一 下 ， 看 看 登录 页 面 是 否 管用 。 请 访问 
http:/Vlocalhost:8000/admin/， 如 果 你 依然 是 以 管理 员 的 身份 登录 的 ， 请 在 页 眉 上 找到 注销 链接 并 
单 击 它 。 

注销 后 , 访问 http://localhost:8000/users/login/， 你 将 看 到 类 似 于 图 19-4 所 示 的 登录 页 面 。 输入 
你 在 前 面 设置 的 用 户 名 和 密码 ， 将 进入 页 面 index。。 在 这 个 主页 的 页 眉 中 ， 显 示 了 一 条 个 性 化 问 
候 语 ， 其 中 包含 你 的 用 户 名 。 
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localhost:8000/users/login/ - chromium 


DD localhost:8000/users/ x 
各 @ [|B localhost:8000/users/login/ 时 


| 
I 


Learning Log - Topics - log in 


Username: | 


Password: | 


EY 


图 19-4 登录 页 面 


19.2.3 ”注销 


现在 需要 提供 一 个 让 用 户 注销 的 途径 。 我 们 不 创建 用 于 注销 的 页 面 , 而 让 用 户 只 需 单 击 一 个 
链接 就 能 注销 并 返回 到 主页 。 为 此 ， 我 们 将 为 注销 链接 定义 一 个 URL 模 式 ， 编 写 一 个 视图 函数 ， 
并 在 base.html 中 添加 一 个 注销 链接 。 

1. 注销 URL 

下 面 的 代码 为 注销 定义 了 URL 模 式 , 该 模式 与 URL http://locallwst:8000/users/logout/ 下 配 。 修 
改 后 的 users/urls.py 如 下 : 


urls.py 


-- Snip-- 
urlpatterns = [ 
# 登录 页 面 
-- Snip-- 
# 注销 
url(r'^logout/$', views.logout view, name="'logout'), 


这 个 URL 模 式 将 请 求 发 送 给 函数 logout_view()。 这 样 给 这 个 函数 命名 ， 旨 在 将 其 与 我 们 将 在 
其 中 调用 的 函数 logout() 区 分 开 来 〈 请 确保 你 修改 的 是 users/urls.py， 而 不 是 learning_log/ urls.py )。 

2. 视图 函数 logout_view() 

函数 logout_view() 很 简单 : 只 是 导 人 Django 函数 1ogout() ， 并 调用 它 ， 再 重 定向 到 主页 。 请 
打开 users/views.py， 并 输入 下 面 的 代码 : 


views.py 


from django.http import HttpResponseRedirect 
from django.core.urlresolvers import reverse 
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@ from django.contrib.auth import logout 


def logout view(request): 


"注销 用 户 "" 
© logout (request) 
(3 return HttpResponseRedirect(reverse('learning logs:index')) 


我 们 从 django.contrib.auth 中 导入 了 函数 logout() ( 见 @ ), 在 @ 处 , 我 们 调用 了 函数 logout()， 
它 要 求 将 request 对 象 作为 实 参 。 然 后 ， 我 们 重 定向 到 主页 ( 见 @ )。 

3. 链接 到 注销 视图 

现在 我 们 需要 添加 一 个 注销 链接 。 我 们 在 base.html 中 添加 这 种 链接 ， 让 每 个 页 面 都 包含 它 ; 
我 们 将 它 放 在 标签 {% if user.is authenticated %} 中 ， 使 得 仅 当 用 户 登 录 后 才能 看 到 它 : 


base.html 


-- SNip- 
{% if user.is authenticated %} 
Hello, {{ user.username }}. 
<a href="{% url 'users:logout' %}">log out</a> 
{% else %} 
<a href="{% url ‘users:login' %}">log in</a> 
{% endif %} 
-- SNip-- 


图 19-5 显 示 了 用 户 登 录 后 看 到 的 主页 。 这 里 的 重点 是 创建 能 够 正确 工作 的 网 站 ， 因 此 几乎 没 
有 设置 任何 样式 。 确 定 所 需 的 功能 都 能 正确 运行 后 , 我 们 将 设置 这 个 网 站 的 样式 , 使 其 看 起 来 更 
专业 。 


localhost:8000 - Chromium 


D localhost:8000 
名 © | 口 localhost8000 立 | 三 


Learning Log - Topics - Hello, ]]_admin. log out 


Learning Log helps you keep track of what you're learning, about any number of topics you're 
working on. 


图 19-5 包含 个 性 化 问候 语 和 注销 链接 的 主页 


下 面 来 创建 一 个 让 新 用 户 能 够 注册 的 页 面 。 我 们 将 使 用 Django 提 供 的 表单 UserCreationForm， 
但 编写 自己 的 视图 函数 和 模板 。 
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1. 注册 页 面 的 URL 模 式 


下 面 的 代码 定义 了 注册 页 面 的 URL 模 式 ， 它 也 包含 在 users/urls.py 中 : 


urls.py 


-- Snip-- 
urlpatterns 


# 录 页 面 

-- Snip-- 

# 注册 页 面 

url(r'^register/$', views.register, name='register'), 


] 


这 个 模式 与 URL http://localhost:8000/users/register/ 匹 配 ， 并 将 请 求 发 送 给 我 们 即将 编写 的 也 
数 register()。 
2. 视图 函数 register() 


在 注册 页 面 首 次 被 请 求 时 ， 视 图 函数 register() 需 要 显示 一 个 空 的 注册 表单 ， 并 在 用 户 提交 
填写 好 的 注册 表单 时 对 其 进行 处 理 。 如 果 注 册 成 功 ， 这 个 函数 还 需 让 用 户 自动 登录 。 请 在 
users/views.py 中 添加 如 下 代码 : 


views.py 


from django 


.Shortcuts import render 
from django. 
from django. 
from django. 
from django. 


http import HttpResponseRedirect 
core.urlresolvers import reverse 

contrib.auth import login, logout, authenticate 
contrib.auth.forms import UserCreationForm 


def logout view(request): 


-- Ship-- 


def register(request): 
if request.method != 'POST': 
# 显示 空 的 注册 表单 
form = UserCreationForm() 


else: 


# 处 理 填 写 好 的 表单 
form = UserCreationForm(data=request.POST) 


if form.is valid(): 


context 


new user = form.save() 

# 让 用 户 自动 登录 ， 再 重 定 向 到 主页 

authenticated user = authenticate(username=new user.username, 
password=request.POST['password1' ]) 

login(request, authenticated user) 

return HttpResponseRedirect(reverse('learning logs:index')) 


= {'form': form} 


return render(request, 'users/register.html', context) 
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我 们 首先 导入 了 函数 render() ， 然 后 导 和 人 了 函数 login() 和 authenticate()， 以 便 在 用 户 正 确 
地 填写 了 注册 信息 时 让 其 自动 登录 。 我 们 还 导 和 了 默认 表单 UserCreationForm。 在 函数 register() 
中 , 我 们 检查 要 响应 的 是 否 是 POST 请 求 。 如 果 不 是 ， 就 创建 一 个 UserCreationForm 实 例 ， 且 不 给 
它 提 供 任 何 初始 数据 ( 见 @ )。 

如 果 响 应 的 是 POST 请 求 ， 我 们 就 根据 提交 的 数据 创建 一 个 UserCreationForm 实 例 ( 见 @ )， 
并 检查 这 些 数据 是 否 有 效 : 就 这 里 而 言 ， 是 用 户 名 未 包含 非法 字符 , 输入 的 两 个 密码 相同 ， 以 及 
用 户 没有 试图 做 恶意 的 事情 。 

如 果 提 交 的 数据 有 效 ， 我 们 就 调用 表单 的 方法 save(), 将 用 户 名 和 密码 的 散 列 值 保存 到 数据 
库 中 ( 见 @ ),。 方法 save() 返 回 新 创建 的 用 户 对 象 ， 我 们 将 其 存储 在 new_user 中 。 

保存 用 户 的 信息 后 ,我 们 让 用 户 自动 登录 , 这 包含 两 个 步骤 ,首先 ,我 们 调用 authenticate()， 
并 将 实 参 new_user.username 和 密码 传递 给 它 ( 见 @ )。 用 户 注 册 时 ， 被 要 求 输入 密码 两 次 ; 由 于 
表单 是 有 效 的 ， 我 们 知道 输入 的 这 两 个 密码 是 相同 的 ， 因 此 可 以 使 用 其 中 任何 一 个 。 在 这 里 , 我 
们 从 表单 的 POST 数据 中 获取 与 键 'password1' 相关 联 的 值 。 如 果 用 户 名 和 密码 无 误 ， 方 法 
authenticate() 将 返回 一 个 通过 了 身份 验证 的 用 户 对 象 ， 而 我 们 将 其 存储 在 authenticated_user 
中 。 接 下 来 ， 我 们 调用 函数 login() ， 并 将 对 象 rfequest 和 authenticated_user 传 递 给 它 〈 见 @ )， 
这 将 为 新 用 户 创建 有 效 的 会 话 。 最 后 ， 我 们 将 用 户 重 定向 到 主页 ( 见 @ )， 其 页 眉 中 显示 了 一 条 
个 性 化 的 问候 语 ， 让 用 户 知道 注册 成 功 了 。 

3. 注册 模板 

注册 页 面 的 模板 与 登录 页 面 的 模板 类 似 ， 请 务必 将 其 保存 到 login.html 所 在 的 目录 中 : 


register.html 


人 


{% extends "learning logs/base.html" %} 
{% block content %} 


<form method="post" action="{% url 'users:register' %}"> 
{% csrf token %} 
{{ form.as p }} 
<button name="submit">register</button> 
<input type="hidden" name="next" value="{% url 'learning logs:index' %}" /> 


</form> 


{% endblock content %} 


这 里 也 使 用 了 方法 as_p， 让 Django 在 表单 中 正确 地 显示 所 有 的 字段 ,包括 错误 消息 一 一 如 果 
用 户 没 有 正确 地 填写 表单 。 


4. 链接 到 注册 页 面 | 
接 下 来 ,我们 添加 这 样 的 代码 ， 即 在 用 户 没 有 登录 时 显示 到 注册 页 面 的 链接 : 
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base.html 


-- Shnip-- 
{% if user.is authenticated %} 
Hello, {{ user.username }}. 
<a_ href="{% url 'users:logout' %}">log out</a> 


{% else %} 
<a href="{% url 'users:register' %}">register</a> - 
<a href="{% url 'users:login' %}">log in</a> 
{% endif %} 
-- Snip-- 


现在 , 已 登录 的 用 户 看 到 的 是 个 性 化 的 问候 语 和 注销 链接 ， 而 未 登录 的 用 户 看 到 的 是 注册 链 
接 和 登录 链接 。 请 尝试 使 用 注册 页 面 创建 几 个 用 户 名 各 不 相同 的 用 户 账户 。 

在 下 一 方 , 我 们 将 对 一 些 页 面 进行 限制 , 仅 让 已 登录 的 用 户 访 问 它们 , 我们 还 将 确保 每 个 主 
题 都 属于 特定 用 户 。 


注意 ”这 里 的 注册 系统 允许 用 户 创建 任意 数量 的 账户 。 有 些 系 统 要 求 用 户 确认 其 身份 : 发 送 一 
封 确认 邮件 ， 用 户 回复 后 其 账户 才 生 效 。 通 过 这 样 做 ， 系 统 生成 的 垃圾 账户 将 比 这 里 使 
用 的 简单 系统 少 。 然 而 ， 学 习 创 建 应 用 程序 时 ， 完 全 可 以 像 这 里 所 做 的 那样 ， 使 用 简单 
的 用 户 注册 系统 。 


动手 试 一 试 
19-2 博客 账户 : 在 你 为 完成 练习 19-1 而 开发 的 项 目 Blog 中 ,添加 一 个 用 户 身 份 验 


证 和 注册 系统 。 让 已 登录 的 用 户 在 屏幕 上 看 到 其 用 户 名 ,并 让 未 注册 的 用 户 看 到 一 个 到 
注册 页 面 的 链接 。 


19.3 ”让 用 户 拥有 自己 的 数据 


用 户 应 该 能 够 输入 其 专 有 的 数据 ， 因 此 我 们 将 创建 一 个 系统 ,确定 各 项 数据 所 属 的 用 户 , 再 
限制 对 页 面 的 访问 ， 让 用 户 只 能 使 用 自己 的 数据 。 

在 本 节 中 ， 我 们 将 修改 模型 Topic， 让 每 个 主题 都 归属 于 特定 用 户 。 这 也 将 影响 条 目 ， 因 为 
每 个 条 目 都 属于 特定 的 主题 。 我 们 先 来 限制 对 一 些 页 面 的 访问 。 


19.3.1 ”使 用 @login required 限制 访问 


Django 提 供 了 装饰 器 elogin_required,， 让 你 能 够 轻松 地 实现 这 样 的 目标 : 对 于 某 些 页 面 ,只 
允许 已 登录 的 用 户 访 问 它们 。 装 饰 器 ( decorator ) 是 放 在 函数 定义 前 面 的 指令 ，Python 在 函数 运 
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行 前 ， 根 据 它 来 修改 函数 代码 的 行为 。 下 面 来 看 一 个 示例 。 

1. 限制 对 topics 页 面 的 访问 

每 个 主题 都 归 特 定 用 户 所 有 ， 因 此 应 只 允许 已 登录 的 用 户 请 求 topics 页 面 。 为 此 ， 在 
learning logs/views.py 中 添加 如 下 代码 : 


views.py 


-- Snip-- 
from django.core.urlresolvers import reverse 
from django.contrib.auth.decorators import login required 


from .models import Topic, Entry 
--SNip-- 


@login required 
def a 
显示 所 有 的 主题 """ 
-snip-- 


站 


我 们 首先 导入 了 涌 数 login required()。 我 们 将 login - ed 人 人 全 全 村 各 全 
topics() 一 一 在 它 前 面 加 上 符号 6 和 1login required， 让 Python 在 运行 topics() 的 代码 前 先 运 行 
login_ required() 的 代码 。 

login_required() 的 代码 检查 用 户 是 否 已 登录 ， 仅 当 用 户 已 登录 时 ，Dijango 才 运行 topics() 
的 代码 。 如 果 用 户 未 登录 ， 就 重 定向 到 登录 页 面 。 

为 实现 这 种 重 定向 ， 我 们 需要 修改 settings.py， 让 Django 知 道 到 哪里 去 查找 登录 页 面 。 请 在 
settings.py 末 尾 添加 如 下 代码 : 


settings.py 


项 目 learning 1og 的 Django 设 置 
-- Ship-- 


# 我 的 设置 
LOGIN URL = '/users/login/" 


现在 ， 如 果 未 登录 的 用 户 请求 装 饰 器 elogin_required 的 保护 页 面 ，Django 将 重 定向 到 
settings.py 中 的 LOGIN_URL 指 定 的 URL。 

要 测试 这 个 设置 ， 可 注销 并 进入 主页 。 然 后 ， 单 击 链接 Topics， 这 将 重 定向 到 登录 页 面 。 接 
下 来 ， 使 用 你 的 账户 登录 ， 并 再 次 单 击 主页 中 的 Topics 链 接 ， 你 将 看 到 topics 页 面 。 

2. 全 面 限 制 对 项 目 “ 学 习 笔 记 ” 的 访问 

Django 让 你 能 够 轻松 地 限制 对 页 面 的 访问 , 但 你 必须 针对 要 保护 哪些 页 面 做 出 决定 。 最 好 先 
确定 项 目的 哪些 页 面 不 需要 保护 , 再 限制 对 其 他 所 有 页 面 的 访问 。 你 可 以 轻松 地 修改 过 于 严格 的 
访问 限制 ， 其 风险 比 不 限制 对 敏感 页 面 的 访问 更 低 。 
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在 项 目 “ 学 习 笔 记 ” 中 ,我 们 将 不 限 


所 有 页 面 的 访问 。 
在 下 面 的 learning logs/views.py 中 ， 对 除 index() 外 的 每 个 视图 都 应 用 了 装饰 器 


@login required: 


vi 


ews.py 


制 对 主页 、 


注册 页 面 和 注销 页 面 的 访问 ， 并 限制 对 其 他 


@ 


@] 


de 


de 


@] 


必 


0@] 


def topics(requ 


login required 


Snip-- 
ogin require 


--Snip-- 
ogin required 


topic(reque 


-- Snip-- 


new topic(r 
-- Snip-- 


ogin required 
f new entry(r 


-- SNnip-- 


ogin required 


-- Snip-- 


est): 


st, topic id): 


equest): 


equest, topic id): 


def edit entry(request, entry id): 


如 果 你 在 未 登录 的 情况 下 尝试 访问 这 些 页 面 , 将 被 重 定向 到 登录 页 面 。 另外， 你 还 不 能 单 击 
到 new_topic 等 页 面 的 链接 。 但 如 果 你 输入 URL http:/localhost:8000mew topic/， 将 重 定向 到 登录 
页 面 。 对 于 所 有 与 私有 用 户 数 据 相 关 的 URL， 都 应 限制 对 它们 的 访问 。 


19.3.2 ”将 数据 关联 到 用 户 


现在 , 需要 将 数据 关联 到 提交 它们 的 用 户 。 我们 只 需 将 最 高 层 的 数据 关联 到 用 户 , 这 样 更 低 
层 的 数据 将 自动 关联 到 用 户 。 例 如 , 在 项 目 “ 学 习 笔 记 ” 中 ,应 用 程序 的 最 高 层 数据 是 主题 ， 而 
所 有 条 目 都 与 特定 主题 相关 联 。 只 要 每 个 主题 都 归属 于 特定 用 户 , 我 们 就 能 确定 数据 库 中 每 个 条 
目的 所 有 者 。 


下 面 来 修改 模型 Topic， 在 其 中 添加 一 个 关联 到 用 户 的 外 键 。 这 样 做 后 ， 我 们 必须 对 数据 库 


进行 迁移 。 最 后 ， 我 们 必须 对 有 些 视图 进行 修改 ， 使 其 只 显示 与 当前 登录 的 用 户 相 关联 的 数据 。 
1. 修改 模型 Topic 


对 models.py 的 修改 只 涉及 两 行 代码 : 


models.py 


from django.db import models 
from django.contrib.auth.models import User 
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class Topic(models.Model) 
”用户 要 学 习 的 主题 ”” 
text = models.CharField(max length=200) 
date added = models.DateTimeField(auto now add=True) 
owner = models.ForeignKey(User) 


def str (self): 
"" "返回 模型 的 字符 事 表 示 """ 
return self.text 


class Entry(models.Model) 
-- Snip-- 


我 们 首先 导入 了 django.contrib.auth 中 的 模型 User， 然 后 在 Topic 中 添加 了 字段 owner， 它 建 
立 到 模型 User 的 外 键 关系 。 

2. 确定 当前 有 哪些 用 户 

我 们 迁移 数据 库 时 ，Django 将 对 数据 库 进行 修改 ,使 其 能 够 存储 主题 和 用 户 之 间 的 关联 。 为 
执行 迁移 ，Django 需 要 知道 该 将 各 个 既 有 主题 关联 到 哪个 用 户 。 最 简单 的 办 法 是 , 将 既 有 主题 都 
关联 到 同一 个 用 户 ， 如 超级 用 户 。 为 此 ， 我 们 需要 知道 该 用 户 的 ID。 

下 面 来 查看 已 创建 的 所 有 用 户 的 ID。 为 此 ， 启 动 一 个 Django shell 会 话 ， 并 执行 如 下 命令 : 


venv)learning log$ python manage.py shell 

@ >>> from django.contrib.auth.models import User 
@ >>> User.objects.all() 

<User: 11 admin>, <User: eric>, <User: willie>] 
@ >>> for user in User.objects.all(): 
print(user.username, user.id) 


1] admin 1 
eric 2 
willie 3 
>>> 


在 @ 处 ， 我 们 在 shell 会 话 中 导入 了 模型 User。 然 后 ,我 们 查看 到 目前 为 止 都 创建 了 哪些 用 户 
( 见 @ )。 输出 中 列 出 了 三 个 用 户 : 11 admin、eric 和 willie。 

在 上 处 ， 我 们 遍历 用 户 列表 ,并 打印 每 位 用 户 的 用 户 名 和 ID。Dijango 询 问 要 将 既 有 主题 关联 
到 哪个 用 户 时 ， 我 们 将 指定 其 中 的 一 个 ID 值 。 

3. 迁移 数据 库 

知道 用 户 ID 后 ， 就 可 以 迁移 数据 库 了 。 


@ (venv)learning log$ python manage.py makemigrations learning logs 

@ You are trying to add a non-nullable field 'owner' to topic without a default; 
we can't do that (the database needs something to populate existing rows). 

四 Please select a fix: 
1) Provide a one-off default now (will be set on all existing rows) 
2) Quit, and let me add a default in models.py 
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@ Select an option: 1 
@ Please enter the default value now, as valid Python 
The datetime and django.utils.timezone modules are available, so you can do e.g. timezone.now() 
© >>> 1 
Migrations for 'learning logs': 
0003_topic owner.py: 
- Add field owner to topic 


我 们 首先 执行 了 命令 makemigrations ( 见 @ ),。 在 @ 处 的 输出 中 ，Django 指 出 我 们 试图 给 既 有 
模型 Topic 添 加 一 个 必 不 可 少 (不 可 为 空 ) 的 字段 ， 而 该 字段 没有 默认 值 。 在 @ 处 ，Django 给 我 
们 提供 了 两 种 选择 : 要 么 现在 提供 默认 值 ， 要 么 退出 并 在 models.py 中 添加 默认 值 。 在 @ 处 ,我 们 
选择 了 第 一 个 选项 ， 因 此 Django 让 我 们 输入 默认 值 ( 见 @ )。 

为 将 所 有 既 有 主题 都 关联 到 管理 用 户 11 admin， 我 输入 了 用 户 ID 值 1 ( 见 @ )。 并 非 必须 使 用 
超级 用 户 ， 而 可 使 用 已 创建 的 任何 用 户 的 ID。 接 下 来 ， Django 使 用 这 个 值 来 迁移 数据 库 ， 并 生成 
了 迁移 文件 0003_topic_owner.py， 它 在 模型 Topic 中 添加 字段 owner。 

现在 可 以 执行 迁移 了 。 为 此 ， 在 活动 的 虚拟 环境 中 执行 下 面 的 命令 : 


(venv)learning log$ python manage.py migrate 
Operations to perform: 
Synchronize unmigrated apps: messages, staticfiles 
Apply all migrations: learning logs, contenttypes, sessions, admin, auth 
-- Ship-- 
Running migrations: 
Rendering model states... DONE 
@ Applying learning logs.0003 topic owner... OK 
(venv)learning log$ 


Django 应 用 新 的 迁移 ， 结 果 一 切 顺 利 ( 见 @ )。 
为 验证 迁移 符合 预期 ， 可 在 shell 会 话 中 像 下 面 这 样 做 : 


@ >>> from learning logs.models import Topic 
@ >>> for topic in Topic.objects.all(): 
print(topic, topic.owner) 


Chess 1] admin 
Rock Climbing 11 admin 
>>> 


我 们 从 learning_ logs.models 中 导入 Topic ( 见 @ )， 再 遍历 所 有 的 既 有 主题 ， 并 打印 每 个 主 
题 及 其 所 属 的 用 户 〈 见 @@ )。 正 如 你 看 到 的 ， 现 在 每 个 主题 都 属于 用 户 1L_admin。 


注意 ”你 可 以 重 置 数据 库 而 不 是 迁移 它 ， 但 如 果 这 样 做 ， 既 有 的 数据 都 将 丢失 。 一 种 不 错 的 做 
法 是 ， 学 习 如 何在 迁移 数据 库 的 同时 确保 用 户 数据 的 完整 性 。 如 果 你 确实 想 要 一 个 全 新 
的 数据 库 ， 可 执行 命令 python manage.py flush， 这 将 重建 数据 库 的 结构 。 如 果 你 这 样 做 ， 
就 必须 重新 创建 超级 用 户 ， 且 原来 的 所 有 数据 都 将 丢失 。 
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19.3.3 只 人 允许 用 户 访问 自己 的 主题 


当前 , 不管 你 以 哪个 用 户 的 身份 登录 ,都 能 够 看 到 所 有 的 主题 。 我 们 来 改变 这 种 情况 ， 只 向 
用 户 显 示 属 于 自己 的 主题 。 
在 views.py 中 ， 对 函数 topics() 做 如 下 修改 : 


views.py 


-- SNip-- 
@login required 
def topics(request): 
"" "显示 所 有 的 主题 """ 
topics = Topic.objects.filter(owner=request.user).order by('date added') 
context = {'topics': topics} 
return render(request, 'learning logs/topics.html', context) 
-- Snip-- 


用 户 登 录 后 ，request 对 象 将 有 一 个 user 属 性 ， 这 个 属性 存储 了 有 关 该 用 户 的 信息 。 代 码 
Topic.objects.filter(owner=request.user) 让 Django 只 从 数据 库 中 获取 owner 属 性 为 当前 用 户 的 
Topic 对 象 。 由 于 我 们 没有 修改 主题 的 显示 方式 ， 因 此 无 需 对 页 面 topics 的 模板 做 任何 修改 。 

要 查看 结果 ， 以 所 有 既 有 主题 关联 到 的 用 户 的 身份 登录 ， 并 访问 topics 页 面 ， 你 将 看 到 所 有 
的 主题 。 然 后 ， 注 销 并 以 另 一 个 用 户 的 身份 登录 ，topics 页 面 将 不 会 列 出 任何 主题 。 


19.3.4 ”保护 用 户 的 主题 


我 们 还 没有 限制 对 显示 单个 主题 的 页 面 的 访问 ， 因 此 任何 已 登录 的 用 户 都 可 输入 类 似 于 
http://localhost:8000/topics/1/ 的 URL， 来 访问 显示 相应 主题 的 页 面 。 

你 自己 试 一 试 就 明白 了 。 以 拥有 所 有 主题 的 用 户 的 身份 登录 , 访问 特定 的 主题 , 并 复制 该 页 
面 的 URL, 或 将 其 中 的 ID 记 录 下 来 。 然后 ,注销 并 以 另 一 个 用 户 的 身份 登录 , 再 输入 显示 前 述 主 
题 的 页 面 的 URL。 昌 然 你 是 以 男 一 个 用 户 登 录 的 ， 但 依然 能 够 查看 该 主题 中 的 条 目 。 

为 修复 这 种 问题 ， 我 们 在 视图 函数 topic() 获 取 请 求 的 条 目前 执行 检查 : 


views.py 


from django.shortcuts import render 

@ from django.http import HttpResponseRedirect, Http404 
from django.core.urlresolvers import reverse 
-- SNip-- 


@login required 
def topic(request, topic id): 
"" "显示 单个 主题 及 其 所 有 的 条 目 """ 
topic = Topic.objects.get(id=topic id) 
# 确认 请 求 的 主题 属于 当前 用 户 
2 if topic.owner != request.user: 
raise Http404 


406 第 19 章 用 户 账户 


entries = topic.entry set.order by('-date added') 

context = {'topic': topic, 'entries': entries} 

return render(request, 'learning logs/topic.html', context) 
-- Snip-- 


服务 器 上 没有 请 求 的 资源 时 ,标准 的 做 法 是 返回 404 响 应 。 在 这 里 ,我们 导入 了 异常 Http404 
( 见 @ )， 并 在 用 户 请 求 它 不 能 查看 的 主题 时 引发 这 个 异常 。 收 到 主题 请 求 后 ,我 们 在 演 染 网 页 前 
检查 该 主题 是 否 属 于 当前 登录 的 用 户 。 如 果 请 求 的 主题 不 归 当 前 用 户 所 有 ， 我 们 就 引发 Http404 
异常 ( 见 @ )， 让 Django 返 回 一 个 404 错 误 页 面 。 

现在 ， 如 果 你 试图 查看 其 他 用 户 的 主题 条 目 ， 将 看 到 Django 发 送 的 消息 Page Not Found。 在 
第 20 章 ， 我 们 将 对 这 个 项 目 进行 配置 ， 让 用 户 看 到 更 合适 的 错误 页 面 。 


19.3.5 ”保护 页 面 edit_entry 


页 面 edit_entry 的 URL 为 http://localhost:8000/edit_ entry/entry id/， 其 中 entry i4 是 一 
个 数字 。 下 面 来 保护 这 个 页 面 ， 禁 止 用 户 通过 输入 类 似 于 前 面 的 URL 来 访问 其 他 用 户 的 条 目 : 


views.py 


-- Snip-- 
@login required 
def edit entry(request, entry id): 
"" "编辑 既 有 条 目 """ 
entry = Entry.objects.get(id=entry id) 
topic = entry.topic 
if topic.owner != request.user: 
raise Http404 
if request.method != “POST : 
出 


'POST 
# 初次 请 求 ， 使 用 当前 条 目的 内 容 填充 表单 


-- SNip-- 


我 们 获取 指定 的 条 目 以 及 与 之 相关 联 的 主题 ， 然 后 检查 主题 的 所 有 者 是 否 是 当前 登录 的 用 
户 ， 如 果 不 是 ， 就 引发 Http404 异 常 。 


19.3.6 ”将 新 主题 关联 到 当前 用 户 


当前 , 用 于 添加 新 主题 的 页 面 存在 问题 ,因此 它 没有 将 新 主题 关联 到 特定 用 户 。 如 果 你 尝试 
添加 新 主题 ， 将 看 到 错误 消息 IntegrityError， 指 出 learning logs topic.user id 不 能 为 NULL。 
Django 的 意思 是 说 ， 创 建新 主题 时 ， 你 必须 指定 其 owner 字 段 的 值 。 

由 于 我 们 可 以 通过 request 对 象 获悉 当前 用 户 ， 因 此 存在 一 个 修复 这 种 问题 的 简单 方案 。 请 
添加 下 面 的 代码 ， 将 新 主题 关联 到 当前 用 户 : 
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views.py 


-- SNip-- 

@login required 

def new topic(request): 
"" "添加 新 主题 """ 


if request.method != “POST : 
# 没有 提交 的 数据 ,创建 一 个 空 表单 
form = TopicForm() 

else: 


# POST 提交 的 数据 ,对 数据 进行 处 理 
form = TopicForm(request.POST) 
if form.is valid(): 
new topic = form.save(commit=False) 
new topic.owner = request.user 
new topic.save() 
return HttpResponseRedirect(reverse('learning logs:topics')) 


@Q@e 


context = {'form': form} 
return render(request, 'learning logs/new topic.html', context) 
-- Snip-- 


我 们 首先 调用 form. save()， 并 传递 实 参 commit=False,， 这 是 因为 我 们 先 修改 新 主题 ,再 将 其 
保存 到 数据 库 中 ( 见 @ )。 接 下 来 ,将 新 主题 的 owner 属 性 设置 为 当前 用 户 ( 见 @ )。 最 后 ， 对 刚 定 
义 的 主题 实例 调用 save() ( 见 @ )。 现 在 主题 包含 所 有 必 不 可 少 的 数据 ， 将 被 成 功 地 保存 。 

现在 , 这 个 项 目 允 许 任何 用 户 注册 ,而 每 个 用 户 想 添加 多 少 新 主题 都 可 以 。 每 个 用 户 都 只 能 
访问 自己 的 数据 ， 无 论 是 查看 数据 、 输 入 新 数据 还 是 修改 旧 数据 时 都 如 此 。 


动手 试 一 斌 

19-3 重 构 : 在 views.py 中 ， 我 们 在 两 个 地 方 核实 主题 关联 到 的 用 户 为 当前 登录 的 
用 户 。 请 将 执行 这 种 检查 的 代码 放 在 一 个 名 为 check topic owner() 的 函数 中 ， 并 在 恰 
当 的 地 方 调用 这 个 函数 。 

19-4 保护 页 面 new_entry: 一 个 用 户 可 在 另 一 个 用 户 的 学 习 笔记 中 添加 条 目 ， 方 法 


是 输入 这 样 的 URL， 即 其 中 包含 输入 另 一 个 用 户 的 主题 的 ID。 为 防范 这 种 攻击 ， 请 在 
保存 新 条 目前 ， 核 实 它 所 属 的 主题 归 当 前 用 户 所 有 。 

19-5 受 保护 的 博客 : 在 你 创建 的 项 目 Blog 中 ,确保 每 篇 博文 都 与 特定 用 户 相 关联 。 
确保 任何 用 户 都 可 访问 所 有 的 博文 ,但 只 有 已 登录 的 用 户 能 够 发 表 博 文 以 及 编辑 既 有 博 
文 。 在 让 用 户 能 够 编辑 其 博文 的 视图 中 , 在 处 理 表单 前 确认 用 户 编辑 的 是 他 自己 发 表 的 
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19.4 ”小 结 


在 本 章 中 ,你 学 习 了 如 何 使 用 表单 来 让 用 户 添加 新 主题 、 添 加 新 条 目 和 编辑 既 有 条 目 。 接 下 
来 ,你 学 习 了 如 何 实现 用 户 账户 。 你 让 老 用 户 能 够 登录 和 注销 ， 并 学 习 了 如 何 使 用 Django 提 供 的 
表单 UserCreationForm 让 用 户 能 够 创建 新 账户 。 

建立 简单 的 用 户 身份 验证 和 注册 系统 后 ,你 通过 使 用 装饰 器 @login required 禁 止 未 登录 的 用 
户 访问 特定 页 面 。 然 后 ,你 通过 使 用 外 键 将 数据 关联 到 特定 用 户 ， 还 学 习 了 如 何 执行 要 求 指定 默 
认 数 据 的 数据 库 迁 移 。 

最 后 ， 你 学 习 了 如 何 修改 视图 函数 ， 让 用 户 只 能 看 到 属于 他 的 数据 。 你 使 用 方法 filter() 来 
获取 合适 的 数据 ， 并 学 习 了 如 何 将 请 求 的 数据 的 所 有 者 同 当前 登录 的 用 户 进 行 比较 。 

该 让 哪些 数据 可 随便 访问 , 该 对 哪些 数据 进行 保护 呢 ? 这 可 能 并 非 总 是 那么 显而易见 , 但 通 
过 不 断 地 练习 就 能 掌握 这 种 技能 。 在 本 章 中 , 我 们 就 该 如 何 保护 用 户 数据 所 做 的 决策 表明 , 与 人 
合作 开发 项 目 是 个 不 错 的 主意 ; 有 人 对 项 目 进行 检查 的 话 ， 更 容易 发 现 其 薄弱 环节 。 

至 此 , 我 们 创建 了 一 个 功能 齐备 的 项 目 , 它 运 行 在 本 地 计算 机 上 。 在 本 书 的 最 后 一 章 , 我 们 
将 设置 这 个 项 目的 样式 , 使 其 更 漂亮 ; 我 们 还 将 把 它 部 署 到 一 台 服 务 器 上 , 让 任何 人 都 可 通过 互 
联网 注册 并 创建 账户 。 


设置 应 用 程序 的 样式 并 对 其 
进行 部 署 


当前 , 项目“ 学 习 笔 记 ” 功 能 已 齐备 ， 但 未 设置 样式 ,也 只 是 在 
本 地 计算 机 上 运行 。 在 本 章 中 ， 0 简单 而 专业 的 方式 设置 这 个 
项 目的 样式 ,再 将 其 部 署 到 一 台 服务 器 上 , 让 世界 上 的 任何 人 都 能 
建立 账户 。 

为 设置 样式 ， 我 们 将 使 用 Bootstrap 库 ， 这 是 一 组 工具 ， 用 于 为 
Web 应 用 程序 设置 样式 , 使 其 在 任何 现代 设备 上 都 看 起 来 很 专业 ,无 
论 是 大 型 的 平板 显示 器 还 是 智能 手机 。 为 此 ,我们 将 使 用 应 用 程序 
django-bootstrap3 ， 这 也 让 你 能 够 练习 使 用 其 他 Django 开 发 人 员 开 发 
的 应 用 程序 。 

我 们 将 把 项 目 “ 学 习 笔 记 ” 部 署 到 Heroku， 这 个 网 站 让 你 能 够 将 项 目 推送 到 其 服务 器 ， 
让 任何 有 网 络 连接 的 人 都 可 使 用 它 。 我 们 还 将 使 用 版 本 控制 系统 Git 来 跟踪 对 这 个 项 目 所 做 
的 修改 。 

完成 项 目 “学 习 笔 记 ” 后 ， 你 将 能 够 开发 简单 的 Web 应 用 程序 ， 让 它们 看 起 来 很 漂亮 ， 
再 将 它们 部 署 到 服务 器 。 你 还 能 够 利用 更 高 级 的 学 习 资 源 来 提高 技能 。 


20.1 设置 项 目 “ 学 习 笔记 ”的 样式 


我 们 一 直 专 注 于 项 目 “ 学 习 笔 记 ” 的 功能 ， 而 没有 考虑 样式 设置 的 问题 ， 这 是 有 意 为 之 的 。 
这 是 一 种 不 错 的 开发 方法 ,因为 能 正确 运行 的 应 用 程序 才 是 有 用 的 。 当 然 ， 应 用 程序 能 够 正确 运 
行 后 ， 外 观 就 显得 很 重要 了 ， 因 为 漂亮 的 应 用 程序 才能 吸引 用 户 使 用 它 。 

在 本 节 中 ， 我 将 简要 地 介绍 应 用 程序 django-bootstrap3 ， 并 演示 如 何 将 其 继承 到 项 目 中 ， 为 
部 署 项 目 做 好 准备 。 
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20.1.1 应 用 程序 django-bootstrap3 


我 们 将 使 用 django-bootstrap3 来 将 Bootstrap 继 承 到 项 目 中 。 这 个 应 用 程序 下 载 必 要 的 Bootstrap 
文件 ， 将 它们 放 到 项 目的 合适 位 置 ， 让 你 能 够 在 项 目的 模板 中 使 用 样式 设置 指令 。 
为 安装 django-bootstrap3 ， 在 活动 的 虚拟 环境 中 执行 如 下 命令 : 


(1] env)learning log$ pip install django-bootstrap3 
-- Snip-- 
Successfully installed django-bootstrap3 


接 下 来 ， 需 要 在 settings.py 的 INSTALLED APPS 中 添加 如 下 代码 ， 在 项 目 中 包含 应 用 程序 
django-boostrap3 : 


settings.py 


-- Snip-- 
INSTALLED APPS = ( 
Snip-- 


‘django.contrib.staticfiles', 


# 第 三 方 应 用 程序 
'bootstrap3', 


# 0 序 
‘learr 


"USeTS" 9 


-- Snip-- 


新 建 一 个 用 于 指定 其 他 开发 人 员 开 发 的 应 用 程序 的 片段 ， 将 其 命名 为 “第 三 方 应 用 程序 ”， 
并 在 其 中 添加 'bootstrap3' 。 大 多 数 应 用 程序 都 需要 包含 在 INSTALLED APPS 中 ， 为 确定 这 一 点 ， 
请 阅读 要 使 用 的 应 用 程序 的 设置 说 明 。 

我 们 需要 让 django-bootstrap3 包 含 jQuery, 这 是 一 个 JavaScript 库 , 让 你 能 够 使 用 Bootstrap 模 板 
提供 的 一 些 交 互 式 元 素 。 请 在 settings.py 的 末尾 添加 如 下 代码 : 


settings.py 


'/users/l1ogin/" 


# django-bootstrap3 的 设置 
BOOTSTRAP3 = { 
'include jquery': True, 


这 些 代码 让 你 无 需 手 工 下 载 jQuery 并 将 其 放 到 正确 的 地 方 。 


20.1 设置 项 目 “ 学 习 笔 记 ” 的 样式 411 


20.1.2 ”使 用 Bootstrap 来 设置 项 目 “ 学 习 笔记 ”的 样式 


Bootstrap 基 本 上 就 是 一 个 大 型 的 样式 设置 工具 集 , 它 还 提供 了 大 量 的 模板 , 你 可 将 它们 应 用 
于 项 目 以 创建 独特 的 总 体 风格 。 对 Bootstrap 初 学 者 来 说 ， 这 些 模板 比 各 个 样式 设置 工具 使 用 起 来 
要 容易 得 多 。 要 查看 Bootstrap 提 供 的 模板 ， 可 访问 http://getbootstrap.com/， 单 击 Getting Started ， 
再 向 下 滚动 到 Examples 部 分 ， 并 找到 Navbars in action。 我 们 将 使 用 模板 Static top navbar， 它 提供 
了 简单 的 顶部 导航 条 、 页 面 标题 和 用 于 放置 页 面 内 容 的 容器 。 

图 20-1 显 示 了 对 base.html 应 用 这 个 Bootstrap 模 板 并 对 index.html 做 细微 修改 后 的 主页 。 


Di LeamingLog 
各 @ |D localhost:8000 空 | 三 


Learning Log 。 Toprcs register login 


Track your learning. 


Register an account to make your own Learning Log, and list the 
topics you're learning about. 


Whenever you learn something new about a topic, make an entry 
summarizing what you've learned. 


图 20-1 项 目 “ 学 习 笔记 ”的 主页 一 一 使 用 Bootstrap 设 置 样式 后 


知道 要 获得 的 效果 后 ， 接 下 来 的 内 容 理 解 起 来 将 更 容易 。 


20.1.3 ”修改 base.html 


我 们 需要 修改 模板 base.html， 以 使 用 前 述 Bootstrap 模 板 。 我 们 把 新 的 base.html 分 成 几 个 部 分 
进行 介绍 。 

1. 定义 HTML 头 半 

对 base.html 所 做 的 第 一 项 修改 是 ， 在 这 个 文件 中 定义 HTML 头 部 ， 使 得 显示 “学 习 笔 记 ” 的 
每 个 页 面 时 ,浏览 器 标题 栏 都 显示 这 个 网 站 的 名 称 。 我 们 还 将 添加 一 些 在 模板 中 使 用 Bootstrap 所 
需 的 信息 。 删 除 base.html 的 全 部 代码 ， 并 输入 下 面 的 代码 : 


base.html 


@ {% 1oad bootstrap3 %} 


@ «<!DOCTYPE html> 
@ <html lang="en"> 
@ “head> 
<meta charset="utf-8"> 


栏 。 
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<meta http-equiv="X-UA-Compatible" content="IE=edge"> 
<meta name="viewport" content="width=device-width, initial-scale=1"> 
© <title>Learning Log</title> 
© {% bootstrap_css %} 
{% bootstrap javascript %} 
@ ‘</head> 


在 @ 处 , 我 们 加 载 了 django-bootstrap3 中 的 模板 标签 集 。 接 下 来 , 我 们 将 这 个 文件 声明 为 使 用 
语 ( 见 @ ) 编 写 的 HTML 文 档 ( 见 @ ), HTML 文 件 分 为 两 个 主要 部 分 : 头 部 (head ) 和 主体 (body ); 
在 这 个 文件 中 ， 头 部 始 于 @ 处 。HTMIL 文 件 的 头 部 不 包含 任何 内 容 : 
的 信息 告诉 浏 览 右 。 在 人 @ 处 ， 我们 包含 了 一 个 title 元 素 ， 


页 面 时 ,浏览 器 的 标题 栏 将 显示 该 元 素 的 内 容 。 


在 @ 人 处 ， 我 们 使 用 了 django-bootstrap3 的 一 个 自 定义 模板 标签 ， 它 让 Django 包 含 所 有 的 
Bootstrap 样 式 文件 。 接 下 来 的 标签 启用 你 可 能 在 页 面 中 使 用 的 所 有 交互 式 行为 ， 如 可 折 寿 的 导航 


区 te 
在 浏览 需 中 打开 网 站 “学 


@ 处 为 结束 标签 </head>。 
2. 定义 导航 栏 
下 面 来 定义 页 面 顶 部 的 导航 栏 : 


-- SNip-- 


Oo 


</head> 


<body> 


<!-- Static navbar --> 
<nav class="navbar navbar-default navbar-static-top"> 
<div class="container"> 


<div class="navbar-header"> 
<button type="button" class="navbar-toggle collapsed" 
data-toggle="collapse" data-target="#navbar" 
aria-expanded="false" aria-controls="navbar"> 
</button> 
<a class="navbar-brand" href="{% url 'learning logs:index' %}"> 
Learning Log</a> 
</div> 


<div id="navbar" class="navbar-collapse collapse"> 
<ul class="nav navbar-nav"> 


<li><a href="{% url] 'learning logs:topics' %}">Topics</a></1i> 


</ul> 


<ul class="nav navbar-nav navbar-right"> 
{% if user.is authenticated %} 
<li><a>Hello, {{ user.username }}.</a></1i> 
<li><a href="{% url 'users:logout' %}">log out</a></1i> 
{% else %} 
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<li><a href="{% url ‘users:register' %}">register</a></l1i> 
<li><a href="{% url 'users:login' %}">log in</a></1i> 
{% endif %} 
© </ul> 
</div><!--/.nav-collapse --> 


</div> 
</nav> 


局 


第 一 个 元 素 为 起 始 标签 cbody>。HTMIL 文 件 的 主体 包含 用 户 将 在 页 面 上 看 到 的 内 容 。 加 处 
一 个 cnav> 元 素 ， 表 示 页 面 的 导航 链接 部 分 。 对 于 这 个 元 素 内 的 所 有 内 容 ， 都 将 根据 选择 
( selector ) navbar 、navbar-default 和 navbar-static-top 定 义 的 Bootstrap 样 式 规则 来 设置 样式 。:; 
择 器 决定 了 特定 样式 规则 将 应 用 于 页 面 上 的 哪些 元 素 。 

在 @@ 处 ， 这 个 模板 定义 了 一 个 按钮 ， 它 将 在 浏览 需 窗 口 太 窗 、 无 法 水 平 显 示 整 个 导航 栏 时 显 
示 出 来 。 如 果 用 户 单 击 这 个 按钮 ,将 出 现 一 个 下 拉 列 表 ， 其 中 包含 所 有 的 导航 元 素 。 在 用 户 缩 小 
浏览 器 窗口 或 在 屏幕 较 小 的 移动 设备 上 显示 网 站 时 ，collapse 会 使 导航 栏 折 释 起 来 。 

在 @ 处 , 我 们 在 导航 栏 的 最 左边 显示 项 目 名 ,并 将 其 设置 为 到 主页 的 链接 ， 因 为 它 将 出 现在 
这 个 项 目的 每 个 页 面 中 。 

在 @ 处 , 我们 定义 了 一 组 让 用 户 能 够 在 网 站 中 导航 的 链接 。 导 航 栏 其 实 就 是 一 个 以 <ul> 打 头 
的 列表 ( 见 @ )， 其 中 每 个 链接 都 是 一 个 列表 项 ( <1i> )。 要 添加 更 多 的 链接 ， 可 插入 更 多 使 用 下 
述 结构 的 行 : 


小 并 


™ 


9 
辫 


党 


<]i><a href="{% url 'Jearning 1ogs:title' %}">Titlexc/a></li> 


这 行 表 示 导 航 栏 中 的 一 个 链接 。 这 个 链接 是 直接 从 base.html 的 前 一 个 版 本 中 复制 而 来 的 。 

在 @ 处 ,我 们 添加 了 第 二 个 导航 链接 列表 ， 这 里 使 用 的 选择 器 为 navpar-right。 选 择 器 
navbar-right 设 置 一 组 链接 的 样式 ,使 其 出 现在 导航 栏 右边 一 一 登录 链接 和 注册 链接 通常 出 现在 
这 里 。 在 这 里 , 我 们 要 么 显示 问候 语 和 注销 链接 ， 要么 显示 注册 链接 和 登录 链接 。 这 部 分 余下 的 
代码 结束 包含 导航 栏 的 元 素 ( 见 @ )。 

3. 定义 页 面 的 主要 部 分 

base.html 的 剩余 部 分 包含 页 面 的 主要 部 分 : 


-- SNip-- 


</nNav> 
© <div class="container"> 
<div class="page-header"> 
[29 {% block header %}{% endblock header %} 
</div> 
<div> 
3 {% block content %}{% endblock content %} 
</div> 
</div> «<!-- /container --> 
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</body> 
</html> 


@ 处 是 一 个 cdiv> 起 始 标 签 ,其 class 属 性 为 container。 div 是 网 页 的 一 部 分 , 可 用 于 任何 目的 ， 
并 可 通过 边框 、 元 素 周 围 的 空间 ( 外 边 距 )、 内 容 和 边框 之 间 的 间距 ( 内 边 距 )、 背 景色 和 其 他 样 
式 规 则 来 设置 其 样式 。 这 个 div 是 一 个 容器 ， 其 中 包含 两 个 元 素 : 一 个 新 增 的 名 为 header 的 块 ( 见 
@ ) 以 及 我 们 在 第 18 章 使 用 的 content 块 ( 见 @ )。header 块 的 内 容 告 诉 用 户 页 面包 含 哪 些 信 息 以 
及 用 户 可 在 页 面 上 执行 哪些 操作 ; 其 class 属 性 值 page-header 将 一 系列 样式 应 用 于 这 个 块 。content 
块 是 一 个 独立 的 div， 未 使 用 class 属 性 指定 样式 。 

如 果 你 在 浏览 器 中 加 载 “ 学 习 笔记 ”的 主页 , 将 看 到 一 个 类 似 于 图 20-1 所 示 的 专业 级 导航 栏 。 
请 尝试 调整 窗口 的 大 小 , 使 其 非常 窗 ; 此 时 导航 栏 将 变 成 一 个 按钮 ， 如 果 你 单 击 这 个 按钮 ， 将 打 
开 一 个 下 拉 列 表 ， 其 中 包含 所 有 的 导航 链接 。 


注意 这 个 简化 的 Bootstrap 模 板 适用 于 最 新 的 浏览 器 ， 而 较 早 的 浏览 器 可 能 不 能 正确 地 泻 染 某 
些 样 式 。 完 整 的 模板 可 在 http://getbootstrap.com/getting-started/#examples/ 找 到 ， 它 几乎 在 
所 有 浏览 器 中 都 管用 。 


20.1.4 ”使 用 jumbotron 设置 主页 的 样式 


下 面 来 使 用 新 定义 的 header 块 及 另 一 个 名 为 jumbotron 的 Bootstrap 元 素 修改 主页 。jumbotron 
元 素 是 一 个 大 框 , 相 比 于 页 面 的 其 他 部 分 显得 知 立 鸡 群 ， 你 想 在 其 中 包含 什么 东西 都 可 以 ; 它 通 
常用 于 在 主页 中 呈现 项 目的 简要 描述 。 我 们 还 可 以 修改 主页 显示 的 消息 。index.html 的 代码 如 下 : 


index.html 


{% extends "learning logs/base.html" %} 


@ {% block header %} 
@ “div class= jumpotron > 
<h1i>Track your learning.</h1> 
</div> 
{% endblock header %} 


{% block content %} 
@ “h2> 
<a href="{% url 'users:register' %}">Register an account</a> to make 
your own Learning Log, and list the topics you're learning about. 
</h2> 
<h2> 
Whenever you learn something new about a topic, make an entry 
summarizing what you've learned. 
</h2> 
{% endblock content %} 
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在 @ 处 ， 我 们 告诉 Django， 我 们 要 定义 header 块 包含 的 内 容 。 在 一 个 jumbotron 元 素 ( 见 @ ) 
中 ， 我 们 放置 了 一 条 简短 的 标语 Track your Learning， 让 首次 访问 者 大 致知 道 “ 学 习 笔记 ” 
是 做 什么 用 的 。 

在 @ 处 , 我们 通过 添加 一 些 文 本 ,做 了 更 详细 的 说 明 。 我 们 邀请 用 户 建立 账户 ， 并 描述 了 用 
户 可 执行 的 两 种 主要 操作 : 添加 新 主题 以 及 在 主题 中 创建 条 目 。 现 在 的 主页 类 似 于 图 20-1 所 示 ， 
与 设置 样式 前 相 比 ， 有 了 很 大 的 改进 。 


20.1.5 ”设置 登录 页 面 的 样式 
我 们 改进 了 登录 页 面 的 整体 外 观 , 但 还 未 改进 登录 表单 ,下 面 来 让 表单 与 页 面 的 其 他 部 分 一 致 : 


login.html 


{% extends "learning logs/base.html" %} 
@ {% load bootstrap3 %} 


@ {% block header %} 
<h2>Log in to your account.</h2> 
{% endblock header %} 


{% block content %} 
©@ <form method="post" action="{% url 'users:login' %}" class="form"> 
{% csrf token %} 
@ {% bootstrap form form %} 
© {% buttons %} 
<button name="submit" class="btn btn-primary">log in</button> 


{% endbuttons %} 


<input type="hidden" name="next" value="{% url] 'learning logs:index' %}" /> 
</form> 


{% endblock content %} 


四 


在 @ 处 ,我 们 在 这 个 模板 中 加 载 了 bootstrap3 模 板 标签 。 在 @ 处 ,我们 定义 了 header 块 ， 它 于 
述 了 这 个 页 面 是 做 什么 用 的 。 注 意 ， 我 们 从 这 个 模板 中 删除 了 {% if form.errors %} 代 码 块 ， 
为 django-bootstrap3 会 自动 管理 表单 错误 。 

在 @ 处 ,我 们 添加 了 属性 class="form"; 然后 使 用 模板 标签 {% bootstrap_form %} 来 显示 表 
单 ( 见 @ ); 这 个 标签 替换 了 我 们 在 第 19 章 使 用 的 标签 {{ form.as p }}。 模 板 标签 {% 
booststrap_form %} 将 Bootstrap 样 式 规则 应 用 于 各 个 表单 元 素 。@ 处 是 bootstrap3 起 始 模 板 标 签 {% 
buttons %}， 它 将 Bootstrap 样 式 应 用 于 按钮 。 

图 20-2 显 示 了 现在 泻 染 的 登录 表单 。 这 个 页 面 比 以 前 整洁 得 多 ， 其 风格 一 致 ， 用 途 明 确 。 如 
果 你 尝试 使 用 错误 的 用 户 名 或 密码 登录 ,将 发 现 消 息 的 样式 与 整个 网 站 也 是 一 致 的 , 毫 无 违 和 感 。 20 
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Learning Log - Chromium 


口 Learning Log x 
各 @ | localhost:8000/users/login/ 了 ?| 三 
Learning Log Topics register login 


Log in to your account. 


Username 


Username 


Password 


Password 


图 20-2 ”使 用 Bootstrap 设 置 样式 后 的 登录 页 面 


20.1.6 设置 new topic 页 面 的 样式 
下 面 来 让 其 他 网 页 的 风格 也 一 致 。 首 先 来 修改 new_topic 页 面 


new _topic.html 


{% extends "learning logs/base.html" %} 
{% load bootstrap3 %} 


@ {% block header %} 
<h2>Add a new topic:</h2> 
{% endblock header %} 
{% block content %} 


@ <form action="{% url 'learning logs:new topic' %}" method="'post' 
class="form"> 


{% csrf token %} 
@ {% bootstrap form form %} 


@ {% buttons %} 
<button name="submit" class="btn btn-primary">add topic</button> 
{% endbuttons %} 


</form> 


{% endblock content %} 


这 里 的 大 多 数 修改 都 类 似 于 对 login.html 所 做 的 修改 : 在 @ 处 加 载 pootstrap3, 添加 header 块 并 
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在 其 中 包含 合适 的 消息 ; 接 下 来 ,我 们 在 标签 <form> 中 添加 属性 class="form"( 见 @ ), 使 用 模板 
标签 {% bootstrap_form %} 代 替 {{ form.as p }} ( 见 @ )， 并 使 用 bootstrap3 结 构 来 定义 提交 按钮 
( 见 @ )。 如 果 你 现在 登录 并 导航 到 new_topic 页 面 ， 将 发 现 其 外 观 类 似 于 登录 页 面 。 


20.1.7 设置 topics 页 面 的 样式 
下 面 来 确保 用 于 查看 信息 的 页 面 的 样式 也 是 合适 的 ， 首 先 来 设置 topics 页 面 的 样式 : 


topics.html 


{% extends "learning logs/base.html" %} 
@ {% block header %} 
<h1>Topics</h1> 
{% endblock header %} 


{% block content %} 


<U]> 
{% for topic in topics %} 
<1i> 
2 <h3> 
<a href="{% url 'learning logs:topic' topic.id %}">{{ topic }}</a> 
</h3> 
</1i> 


{% empty %} 
<li>No topics have been added yet.</1i> 
{% endfor %} 
</U]> 


@ “h3><a href="{% url 'learning logs:new topic' %}">Add new topic</h3> 


{% endblock content %} 


我 们 不 需要 标签 {% load bootstrap3 %}， 因 为 我 们 在 这 个 文件 中 没有 使 用 任何 bootstrap3 自 
定义 标签 。 我 们 在 header 块 中 添加 了 标题 Topics ( 见 @ )。 为 设置 每 个 主题 的 样式 ， 我 们 将 它们 都 
设置 为 ch3> 元 素 ， 让 它们 在 页 面 上 显得 大 些 ( 见 @ ); 对 于 添加 新 主题 的 链接 ， 也 做 了 同样 的 处 
理 ( 见 @ )。 


20.1.8 ”设置 topic 页 面 中 条 目的 样式 


topic 页 面包 含 的 内 容 比 其 他 大 部 分 页 面 都 多 ,因此 需要 做 的 样式 设置 工作 要 多 些 。 我 们 将 使 
用 Bootstrap 面 板 ( panel ) 来 突出 每 个 条 目 。 面 板 是 一 个 带 预定 义 样式 的 div， 非 常 适合 用 于 显示 
主题 的 条 目 : 


topic.html 


{% extends 'learning logs/base.html' %} 
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@ {% block header %} 
<h2>{{ topic }}</h2> 
{% endblock header %} 


{% block content %} 
<p> 


Qf 


<a href="{% url 'learning logs:new entry' topic.id %}">add new entry</a> 
p> 


{% for entry in entries %} 


©@ OO® 


[0 


<div class="panel panel-default"> 
<div class="panel-heading"> 
<h3> 
{{ entry.date added|date:'M d, Y H:i' }} 
<small> 
<a href="{% url 'learning logs:edit entry' entry.id %}"> 
edit entry</a> 
</small> 
</h3> 
</div> 
<div class="panel-body"> 
{{ entry.text|linebreaks }} 
</div> 
</div> <!-- panel --> 


{% empty %} 


There are no entries for this topic yet. 


{9 
0 


{% [3 


endfor %} 


ndblock content %} 


我 们 首先 将 主题 放 在 了 header 块 中 ( 见 @ )。 然 后 ， 我 们 删除 了 这 个 模板 中 以 前 使 用 的 无 序 
列表 结构 。 在 @ 人 处 ， 我 们 创建 了 一 个 面板 式 div 元 素 ( 而 不 是 将 每 个 条 目 作 为 一 个 列表 项 )， 其 中 
包含 两 个 铝 套 的 div: 一 个 面板 标题 ( panel-heading ) div ( 见 @ ) 和 一 个 面板 主体 ( panel-body ) 


div( 见 @ 


/ 


) 其 中 面板 标题 div 包 含 条 目的 创建 日 期 以 及 用 于 编辑 条 目的 链接 , 它们 都 被 设置 为 <h3> 


元 素 ， 而 对 于 编辑 条 目的 链接 ， 还 使 用 了 标签 csmal1>， 使 其 比 时 间 戳 小 些 ( 见 日 )。 


@ 处 


是 面板 主体 div, 其 中 包含 条 目的 实际 文本 。 注意 , 只 修改 了 影响 页 面 外 观 的 元 素 , 对 在 


页 面 中 包含 信息 的 Django 代 码 未 做 任何 修改 。 
图 20-3 显 示 了 修改 后 的 topic 页 面 。 “学习 笔记 ”的 功能 没有 任何 变化 ,但 显得 更 专业 了 ,对 
用 户 会 更 有 吸引 力 。 


20.2 部署“ 学 习 笔 记 ” 419 


Learning Log - Chromium 
D Learning Log x 


和 © BD localhost:8000/topics/1/ 安 三 
Learning Log Topics Hello,lLadmin log out 
Chess 


add new entry 


Jun 12, 2015 15:30 editentry 


The bishops and knights are good pieces to have out in the opening phase of the game. Theyre both powerful enough to be useful in attacking 
your opponent, but not so powerful that you can't afford to lose them in an early trade. 


May 28, 2015 04:39 editentry 


In the opening phase of the game, its important to bring out your bishops and knights. These pieces are powerful and maneuverable enough to 
play a significant role in the beginning moves of a game. 


May 28, 2015 04:39 editentry 四 


The opening is the first part of the game, roughly the first ten moves or so. In the opening, it's a good idea to do three things 一 bring out your 
L_ hishans and kninhts tn castle vnur kinn 和 


图 20-3 ”使 用 Bootstrap 设 置 样式 后 的 topic 页 因 


注意 要 使 用 其 他 Bootstrap 模 板 , 可 采用 与 本 章 类 似 的 流程 : 将 这 个 模板 复制 到 base.html 中 ,并 
修改 包含 实际 内 容 的 元 素 ， 以 使 用 该 模板 来 显示 项 目的 信息 ; 然后 ， 使 用 Bootstrap 的 样 
式 设置 工具 来 设置 各 个 页 面 中 内 容 的 样式 。 


动手 试 一 斌 
20-1 其 他 表单 : 我 们 对 登录 页 面 和 add topic 页 面 应 用 了 Bootstrap 样式 。 请 对 其 


他 基于 表单 的 页 面 做 类 似 的 修改 : new entry 页 面 、edit entry 页 面 和 注册 页 面 。 
20-2 设置 博客 的 样式 : 对 于 你 在 第 19 章 创建 的 项 目 Blog， 使 用 Bootstrap 来 设置 
其 样式 。 


20.2 部署“ 学习 笔记 ” 
至 此 , 项目 “学 习 笔记 ”的 外 观 显得 很 专业 了 ， 下面 来 将 其 部 署 到 一 台 服 务 器 ,让 任何 有 网 20 
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络 连接 的 人 都 能 够 使 用 它 。 为 此 ， 我 们 将 使 用 Heroku， 这 是 一 个 基于 Web 的 平台 ， 让 你 能 够 管理 
Web 应 用 程序 的 部 署 。 我 们 将 让 “学 习 笔 记 ” 在 Heroku 上 运行 。 

在 Windows 系 统 上 的 部 署 过 程 与 在 Linux 和 OS X 系 统 上 稍 有 不 同 。 如 果 你 使 用 的 是 Windows， 
请 阅读 各 节 的 “注意 ”， 它 们 指出 了 在 Windows 系 统 上 需要 采取 的 不 同 做 法 。 


20.2.1 建立 Heroku 账户 


要 建立 账户 ， 请 访问 https:/heroku.com/， 并 单 击 其 中 的 一 个 注册 链接 。 注 册 账 户 是 免费 的 ， 
Heroku 提 供 了 免费 试用 服务 ， 让 你 能 够 将 项 目 部 署 到 服务 器 并 对 其 进行 测试 。 


注意 Heroku 提 供 的 免费 试用 服务 存在 一 些 限制 ， 如 可 部 署 的 应 用 程序 数量 以 及 用 户 访问 应 用 
程序 的 频率 。 但 这 些 限制 都 很 宽松 ， 让 你 完全 能 够 在 不 支付 任何 费用 的 情况 下 练习 部 署 
应 用 程序 。 


20.2.2 ”安装 Heroku Toolbelt 


要 将 项 目 部 署 到 Heroku 的 服务 器 并 对 其 进行 管理 ， 需 要 使 用 Heroku Toolbelt 提 供 的 工具 。 要 


安装 最 新 的 Heroku Toolbelt 版 本 ， 请 访问 https://toolbelt.heroku.com/， 并 根据 你 使 用 的 操作 系统 按 
相关 的 说 明 做 : 使 用 只 包含 一 行 的 终端 命令 ， 或 下 载 并 运行 安装 程序 。 


20.2.3 ”安装 必要 的 包 


你 还 需 安装 很 多 包 ,， 以 帮助 在 服务 器 上 支持 Django 项 目 提 供 的 服务 。 为 此 , 在 活动 的 虚拟 环 
境 中 执行 如 下 命令 : 


(11] env)learning log$ pip install dj-database-url 
(11] env)learning log$ pip install dj-static 

(11_env)learning log$ pip install static3 
(11_env)learning log$ pip install gunicorn 


务必 逐个 地 执行 这 些 命令 , 这 样 你 就 能 知道 哪些 包 未 能 正确 地 安装 。dj-database-url 包 帮助 
Django 与 Heroku 使 用 的 数据 库 进行 通信 , dj-static 和 static3 包 帮助 Django 正 确 地 管理 静态 文件 ， 
而 gunicorn 是 一 个 服务 器 软件 ， 能 够 在 在 线 环 境 中 支持 应 用 程序 提供 的 服务 。( 静态 文件 包括 样 
式 规则 和 JavaScript 文 件 。) 


注意 ， 在 Windows 系 统 中 ， 有 些 必 不 可 少 的 包 可 能 无 法 安装 ， 因 此 如 果 在 你 尝试 安装 有 些 这 样 
的 包 时 出 现 错误 消息 ， 也 不 用 担心 。 重 要 的 是 让 Heroku 在 部 署 中 安装 这 些 包 ， 下 一 节 就 


将 这 样 做 。 
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20.2.4 创建 包含 包 列 表 的 文件 requirements.txt 


Heroku 需 要 知道 我 们 的 项 目 依赖 于 哪些 包 ， 因 此 我 们 将 使 用 pip 来 生成 一 个 文件 ， 其 中 列 出 


了 这 些 包 。 同 样 ， 进 入 活动 虚拟 环境 ， 并 执行 如 下 命令 : 


(11 env)learning log$ pip freeze > requirements.txt 


命令 freeze 让 pip 将 项 目 中 当前 安装 的 所 有 包 的 名 称 都 写 人 到 文件 requirements.txt 中 。 请 打开 
文件 requirements.txt， 查 看 项 目 中 安装 的 包 及 其 版 本 ( 如 果 你 使 用 的 是 Windows 系 统 ， 看 到 的 内 


容 可 能 不 全 ): 


redquirements .txt 


Django==1.8.4 
dj-database-url==0.3.0 
dj-static==0.0.6 
django-bootstrap3==6.2.2 
gunicorn==19.3.0 
static3==0.6.1 


“学 习 笔记 ”依赖 于 6 个 特定 版 本 的 包 ， 因 此 需要 在 相应 的 环境 中 才能 正确 ] 


地 运行 。 我 们 部 署 


“学 习 笔 记 ” 时 ，Heroku 将 安装 requirements.txt 列 出 的 所 有 包 ， 从 而 创建 一 个 环境 ， 其 中 包含 我 们 
在 本 地 使 用 的 所 有 包 。 有 鉴于 此 , 我 们 可 以 信心 满 满 ， 深信 项 目 部 署 到 Heroku 后 , 行为 将 与 它 在 


本 地 系统 上 的 完全 相同 。 当 你 在 自己 的 系统 上 开发 并 维护 各 种 项 目 时 ， 这 将 是 


一 个 巨大 的 优点 。 


接 下 来 ,我 们 需要 在 包 列 表 中 添加 psycopg2， 它 帮助 Heroku 管 理 活动 数据 库 。 为 此 ， 打 开 文 
件 requirements.txt， 并 添加 代码 行 psycopg2>=2.6.1。 这 将 安装 2.6.1 版 的 psycopg2 一 一 如 果 有 更 高 


的 版 本 ， 则 安装 更 高 的 版 本 : 


redquirements.txt 


Django==1.8.4 
dj-database-url==0.3.0 
dj-static==0.0.6 
django-bootstrap3==6.2.2 
gunicorn==19.3.0 
static3==0.6.1 
psycopg2>=2.6.1 


如 果 有 必 不 可 少 的 包 在 你 的 系统 中 没有 安装 ， 请 将 其 添加 到 文件 requirements.txt 中 。 最 终 的 


文件 requirements.txt 应 包含 上 面 列 出 的 每 个 包 。 如 果 在 你 的 系统 中 , requirement 
本 与 上 面 列 出 的 不 同 ， 请 保留 原来 的 版 本 号 。 


s.txt 列 出 的 包 的 版 


注意 ”如果 你 使 用 的 是 Windows 系 统 ， 请 确保 文件 requirements.txt 的 内 容 与 前 面 列 出 的 一 致 ， 而 


不 要 管 你 在 系统 中 能 够 安装 哪些 包 。 
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20.2.5 指定 Python 版 本 


如 果 你 没有 指定 Python 版 本 ，Heroku 将 使 用 其 当前 的 Python 默认 版 本 。 下 面 来 确保 Heroku 使 
用 我 们 使 用 的 Python 版 本 。 为 此 ， 在 活动 的 虚拟 环境 中 ， 执 行 命令 python --version: 


(11_env)learning log$ python --version 
Python 3.5.0 


上 面 的 输出 表明 ， 我 使 用 的 是 Python 3.5.0。 请 在 manage.py 所 在 的 文件 夹 中 新 建 一 个 名 为 
runtime.txt 的 文件 ， 并 在 其 中 输入 如 下 内 容 : 


runtime.txt 


python-3.5.0 


这 个 文件 应 只 包含 一 行内 容 ， 以 上 面 所 示 的 格式 指定 了 你 使 用 的 Python 版 本 ; 请 确保 输入 小 
写 的 pytnon， 在 它 后 面 输入 一 个 连 字符 ， 再 输入 由 三 部 分 组 成 的 版 本 号 。 


注意 如 果 出 现 错误 消息 ， 指 出 不 能 使 用 你 指定 的 Python 版 本 ， 请 访问 https:/devcenter. 
heroku.com/ 并 单 击 Python， 再 单 击 链接 Specifying a Python Runtime。 浏 览 打开 的 文章 ， 了 
解 支持 的 Python 版 本 ， 并 使 用 与 你 使 用 的 Python 版 本 最 接近 的 版 本 。 


20.2.6 ”为 部 署 到 Herohu 而 修改 settings.py 


现在 需要 在 settings.py 末 尾 添加 一 个 片段 ， 在 其 中 指定 一 些 Heroku 环 境 设置 : 


settings.py 


-- Snip-- 
# django-bootstrap3 设 置 
BOOTSTRAP3 = { 

'include jquery': True, 


} 


# Heroku 设 置 
@ if os.getcwd() == '/app': 
2 import dj database url 
DATABASES = { 
‘default': dj database url.config(default="postgres://localhost') 
} 


# 让 request.is_secure() 承 认 X-Forwarded-Proto 头 
日 SECURE PROXY SSL HEADER = ('HTTP _X FORWARDED PROTO', 'https') 


# 支持 所 有 的 主机 头 (host header) 
@ ALLOWED_ HOSTS = 世 兴 5] 
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# 静态 资产 配置 
(5 BASE DIR = os.path.dirname(os.path.abspath(_ file )) 
STATIC ROOT = 'staticfiles" 
STATICFILES DIRS = (人 
os.path.join(BASE DIR, "static' )， 
) 


在 @ 处 ,我 们 使 用 了 函数 getcwd()， 它 获取 当前 的 工作 目录 ( 当前 运行 的 文件 所 在 的 目录 )。 
在 Heroku 部 署 中 ， 这 个 目录 总 是 /app。 在 本 地 部 署 中 ， 这 个 目录 通常 是 项 目 文 件 夹 的 名 称 ( 就 我 
们 的 项 目 而 言 ， 为 learning log )。 这 个 if 测 试 确保 仅 当 项 目 被 部 署 到 Heroku 时 ， 才 运行 这 个 代码 
块 。 这 种 结构 让 我 们 能 够 将 同一 个 设置 文件 用 于 本 地 开发 环境 和 在 线 服务 器 。 

在 @ 人 处 ,我们 导入 了 dj_database_url1， 用 于 在 Heroku 上 配置 服务 器 。Heroku 使 用 PostgreSQL 
(也 叫 Postgres ) 一 种 比 SQLite 更 高 级 的 数据 库 ; 这 些 设置 对 项 目 进 行 配置 ， 使 其 在 Heroku 上 
使 用 Postgres 数 据 库 。 其 他 设置 的 作用 分 别 如 下 : 支持 HTTPS 请 求 ( 见 @ ); 让 Django 能 够 使 用 
Heroku 的 URL 来 提供 项 目 提供 的 服务 ( 见 @ ); 设置 项 目 ， 使 其 能 够 在 Heroku 上 正确 地 提供 静态 
文件 ( 见 @ )。 


20.2.7 ”创建 启动 进程 的 Procfile 


Procfile 告 诉 Heroku 启 动 哪些 进程 , 以 便 能 够 正确 地 提供 项 目 提供 的 服务 。 这 个 文件 只 包含 一 
行 ， 你 应 将 其 命名 为 Procfile( 其 中 的 P 为 大 写 )， 不 指定 文件 扩展 名 ， 并 保存 到 manage.py 所 在 的 
目录 中 。 

Procfile 的 内 容 如 下 : 


Procfile 


web: gunicorn learning log.wsgi --log-file - 


这 行 代码 让 Heroku 将 gunicorn 用 作 服 务 器 , 并 使 用 learning log/wsgi.py 中 的 设置 来 启动 应 用 程 
序 。 标 志 log-file 告 诉 Heroku 应 将 哪些 类 型 的 事件 写 人 日 志 。 


20.2.8 为 部 署 到 Herohu 而 修改 wsgi.py 


为 部 署 到 Heroku , 我 们 还 需 修 改 wsgi.py, 因为 Heroku 需 要 的 设置 与 我 们 一 直 在 使 用 的 设置 稍 
有 不 同 : 


wsgi.py 


-- SNip-- 
import os 


from django.core.wsgi import get wsgi application 
from dj static import Cling 
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os.environ.setdefault("DJANGO SETTINGS _ MODULE"， "learning log.settings") 
pp leation: = = Cling(get wsgi application()) 


我 们 导入 了 帮助 正确 地 提供 静态 文件 的 Cling， 并 使 用 它 来 启动 应 用 程序 。 这 些 代码 在 本 地 
也 适用 ， 因 此 无 需 将 其 放 在 if 代 码 块 内 。 


20.2.9 创建 用 于 存储 静态 文件 的 目录 


在 Heroku 上 ， Django 搜集 所 有 的 静态 文件 ， 并 将 它们 放 在 一 个 地 方 ， 以 便 能 够 高 效 地 管理 它 

们 。 我 们 将 创建 一 个 用 于 存储 这 些 静 态 文 件 的 目录 。 在 文件 夹 learning_log 中 ， 有 一 个 名 称 也 为 

loorhing lo /| 在 这 个 子 文件 夹 中 , 新 建 一 个 名 为 static 的 文件 夹 , 因此 这 个 文件 夹 的 路 

径 为 leaming log/learning log/static/。 我 们 还 需 在 这 个 文件 夹 中 创建 一 个 占 位 文件 , 因为 项 目 被 推 

送 到 Heroku 时 ， 它 将 不 会 包含 原来 为 空 的 文件 夹 。 在 目录 static/ 中 ， 创 建 一 个 名 为 placeholder.txt 
的 文件 : 


placeholder.txt 


This file ensures that learning log/static/ will be added to the project. 
Django will collect static files and place them in learning log/static/. 


上 述 内 容 没 有 什么 特别 之 处 ， 只 是 指出 了 在 项 目 中 添加 这 个 文件 的 原因 。 


20.2.10 ”在 本 地 使 用 gunicorn 服务 器 


如 果 你 使 用 的 是 Linux 或 0S X， 可 在 部 署 到 Heroku 前 尝试 在 本 地 使 用 gunicorm 服 务 器 。 为 此 ， 
在 活动 的 虚拟 环境 中 ， 执 行 命令 heroku local 以 启动 Procfile 指 定 的 进程 : 


(11_env)learning log$ heroku local 
Installing Heroku Toolbelt v4... done 
-- Ship-- 
forego | starting web.1 on port 5000 
@ web.1 [2015-08-13 22:00:45 -0800] [12875] [INFO] Starting gunicorn 19.3.0 
@ web.1 [2015-08-13 22:00:45 -0800] [12875] [INFO] Listening at: 
http://0.0.0.0:5000 (12875) 
四 web.1 [2015-08-13 22:00:45 -0800] [12878] [INFO] Booting worker with pid: 12878 


首次 执行 命令 heroku local 时 ， 将 安装 Heroku Toolbelt 中 的 很 多 包 。 这 里 的 输出 表明 启动 了 
gunicormn ， 其 进程 id 为 12875( 见 @ )。@ 处 的 输出 表明 ，gunicorn 在 端口 5000 上 侦 听 请 求 。 男 外 ， 
gunicorn 还 启动 了 一 个 工作 进程 ( 12878 )， 用 于 帮助 处 理 请 求 ( 见 @ )。 

为 确认 一 切 运 行 正常 ， 请 访问 http://localhost:5000/， 你 将 看 到 “学 习 笔记 ”的 主页 ， 就 像 使 
用 Django 服 务 器 ( runserver ) 时 一 样 。 为 停止 heroku local 启 动 的 进程 ， 请 按 Ctrl + C， 你 将 在 本 
地 开发 中 继续 使 用 runserver。 
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:十 二 
注 E33 
/5、 


gunicorn 不 能 在 Windows 系 统 上 运行 , 因此 如 果 你 使 用 的 是 Windows 系 统 , 请 跳 过 这 一 步 。 
但 这 不 会 影响 你 将 项 目 部 署 到 Heroku。 


20.2.11 ”使 用 Git 跟踪 项 目 文件 


如 果 你 阅读 完了 第 17 章 ， 就 知道 Git 是 一 个 版 本 控制 程序 ， 让 你 能 够 在 每 次 成 功 实现 新 功能 


后 都 拍摄 项 目 代 码 的 快照 。 无 论 出 现 什 么 问题 ( 如 实现 新 功能 时 不 小 心 引 入 了 bug ), 你 都 可 以 轻 
松 地 恢复 到 最 后 一 个 可 行 的 快照 。 每 个 快照 都 被 称 为 提交 。 


使 用 Git 意 味 着 你 在 试 着 实现 新 功能 时 无 需 担心 破坏 项 目 。 将 项 目 部 署 到 服务 器 时 ， 需 要 确 


保 部 署 的 是 可 行 版 本 。 如 果 你 想 更 详细 地 了 解 Git 和 版 本 控制 ， 请 参阅 附录 D。 


1. 安装 Git 
Heroku Toolbelt 包 含 Git， 因 此 它 应 该 已 经 安装 到 了 你 的 系统 中 。 然 而 ， 在 安装 Heroku Toolbelt 之 


前 打开 的 终端 窗口 中 无 法 访问 Git, 因此 请 打开 一 个 新 的 终端 窗口 , 并 在 其 中 执行 命令 git --version: 


(11 env)learning log$ git --version 
git version 2.5.0 


如 果 由 于 某 种 原因 出 现 了 错误 消息 ， 请 参阅 附录 D 中 的 Git 安 装 说 明 。 


2. 配置 Git 
Git 跟 踪 谁 修改 了 项 目 ， 即 便 项 目 由 一 个 人 开发 时 亦 如 此 。 为 进行 跟踪 ，Git 需 要 知道 你 的 用 


户 名 和 email。 因 此 ， 你 必须 提供 用 户 名 ， 但 对 于 练习 项 目 ， 可 随便 伪造 一 个 email: 


(11 env)learning log$ git config --global user.name "ehmatthes" 
(11_env)learning log$ git config --global user.email "eric@example.com" 


如 果 你 忘记 了 这 一 步 ， 当 你 首次 提交 时 ，Git 将 提示 你 提供 这 些 信息 。 


3. 忽略 文件 
我 们 无 需 让 Git 跟 踪 项 目 中 的 每 个 文件 ,因此 将 让 Git 忽 略 一 些 文件 。 为 此 , 在 manage.py 所 在 


的 文件 夹 中 创建 一 个 名 为 .gitignore 的 文件 。 注 意 ， 这 个 文件 名 以 句点 打头 ， 且 不 包含 扩展 名 。 在 


这 个 文件 中 输入 如 下 内 容 : 
.gitignore 
ll env/ 
_Ppycache _/ 
*.sqlite3 


我 们 让 Git 忽 略 目录 i! env， 因 为 我 们 随时 都 可 以 自动 重新 创建 它 。 我 们 还 指定 不 跟踪 目录 


_ pycache ”， 这 个 目录 包 仿 Django 运行 .py 文件 时 自动 创建 的 .pyc 文 件 。 我 们 没有 跟踪 对 本 地 数 
据 库 的 修改 ， 因 为 这 是 一 个 糟糕 的 做 法 如 果 你 在 服务 器 上 使 用 的 是 SQLite， 当 你 将 项 目 推 送 到 
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服务 器 时 ， 可 能 会 不 小 心 用 本 地 测试 数据 库 覆 盖 在 线 数据 库 。 


注意 ”如果 你 使 用 的 是 Python 2.7， 请 将 pycache 替换 为 *.pyc， 因 为 Python 2.7 不 会 创建 目录 
_ pycache 。 


4. 提交 项 目 
我 们 需要 为 “学 习 笔记 ”初始 化 一 个 Git 仓 库 ， 将 所 有 必要 的 文件 都 加 入 到 这 个 仓库 中 ， 并 
提交 项 目的 初始 状态 ， 如 下 所 示 : 


@ (1] env)learning log$ git init 
Initialized empty Git repository in /home/ehmatthes/pcc/learning log/.git/ 
@ (ll env)learning log$ git add . 
@ (1]1 env)learning log$ git commit -am "Ready for deployment to heroku." 
[master (root-commit) dbc1d99] Ready for deployment to heroku. 
43 files changed, 746 insertions(+) 
create mode 100644 .gitignore 
create mode 100644 Procfile 
-- Snip-- 
create mode 100644 users/views.py 
@ (ll env)learning log$ git status 
# On branch master 
nothing to commit, working directory clean 
(1] env)learning log 


在 @ 处 ,我 们 执行 命令 git init， 在“ 学习 笔记 ”所 在 的 目录 中 初始 化 一 个 空仓 库 。 在 @ 处 ， 
我 们 执行 了 命令 git add .( 千 万 别 忘 了 这 个 句点 )， 它 将 未 被 忽略 的 文件 都 添加 到 这 个 仓库 中 。 
在 @ 处 ， 我 们 执行 了 命令 git commit -am commit message， 其 中 的 标志 -a 让 Git 在 这 个 提交 中 包含 
所 有 修改 过 的 文件 ， 而 标志 -mi 上 Git 记 录 一 条 日 志 消 息 。 

在 @ 处 ， 我 们 执行 了 命令 git status， 输 出 表明 当前 位 于 分 支 master 中 ， 而 工作 目录 是 干净 
(clean ) 的 。 每 当 你 要 将 项 目 推送 到 Heroku 时 ， 都 希望 看 到 这 样 的 状态 。 


20.2.12 ”推送 到 Heroku 
我 们 终于 为 将 项 目 推送 到 Heroku 做 好 了 准备 。 在 活动 的 虚拟 环境 中 ， 执 行 下 面 的 命令 : 


@ (1] env)learning log$ heroku login 
Enter your Heroku credentials. 
Email: eric@example.com 
Password (typing will be hidden): 
Logged in as eric@example.com 
@ (]1 env)learning log$ heroku create 
Creating afternoon-meadow-2775... done, stack is cedar-14 
https://afternoon-meadow-2775.herokuapp.com/ 
https://git.heroku.com/afternoon-meadow-2775.git 
Git remote heroku added 
© (1] env)learning log$ git push heroku master 
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remote: ----- > Launching... done, v6 
@ remote: https://afternoon-meadow-2775.herokuapp.com/ deployed to Heroku 
remote: Verifying deploy.... done. 


To https://git.heroku.com/afternoon-meadow-2775.git 
bdb2a35..62d711d master -> master 
(11 env)learning log$ 


首先 ， 在 终端 会 话 中 ， 使 用 你 在 https://heroku.com/ 创 建 账户 时 指定 的 用 户 名 和 密码 来 登录 
Heroku ( 见 @ )。 然后， 让 Heroku 创 建 一 个 空 项 目 ( 见 @ )。Heroku 生 成 的 项 目 名 由 两 个 单词 和 一 
个 数字 组 成 ， 你 以 后 可 修改 这 个 名 称 。 接 下 来 ， 我 们 执行 命令 git push heroku master ( 见 @ )， 
它 让 Git 将 项 目的 分 支 master 推 送 到 Heroku 刚 才 创 建 的 仓库 中 ; Heroku 随 后 使 用 这 些 文件 在 其 服务 
器 上 创建 项 目 。@ 处 列 出 了 用 于 访问 这 个 项 目的 URL。 

执行 这 些 命令 后 ,项 目 就 部 署 好 了 , 但 还 未 对 其 做 全 面 的 配置 。 为 核实 正确 地 启动 了 服务 器 
进程 ， 请 执行 命令 heroku ps: 


(11 env)learning log$ heroku ps 
Free quota left: 17h 40m 

= web (Free):“gunicorn learning log.wsgi log-file - 
b.1: up 2015/08/14 07:08:51 (~ 10m ago) 

]_ env)learning log$ 


输出 指出 了 在 接 下 来 的 24 小 时 内 ,项 目 还 可 在 多 长 时 间 内 处 于 活动 状态 ( 见 @ )。 编 写本 书 
时 ,Heroku 人 允许 免费 部 署 在 24 小 时 内 最 多 可 以 有 18 小 时 处 于 活动 状态 。 项 目的 活动 时 间 超 过 这 个 
限制 后 , 将 显示 标准 的 服务 器 错误 页 面 ， 稍 后 我 们 将 设置 这 个 错误 页 面 。 在 @ 处 ,我 们 发 现 启 动 
了 Procfile 指 定 的 进程 。 

现在 ， 我 们 可 以 使 用 命令 heroku open 在 浏览 器 中 打开 这 个 应 用 程序 了 : 


(11 env)learning log$ heroku open 
Opening afternoon-meadow-2775... done 


你 也 可 以 启动 浏览 器 并 输入 Heroku 告 诉 你 的 URL, 但 上 述 命 令 可 实现 同样 的 结果 。 你 将 看 到 
“学 习 笔 记 ” 的 主页 ， 其 样式 设置 正确 无 误 ， 但 你 还 无 法 使 用 这 个 应 用 程序 ， 因 为 我 们 还 没有 建 
立 数据 库 。 


注意 ”部署 到 Heroku 的 流程 会 不 断 变 化 。 如 果 你 遇 到 无 法 解决 的 问题 ， 请 通过 查看 Heroku 文 档 
来 获取 帮助 。 为 此 ， 可 访问 https://devcenter.heroku.com/， 单 击 Python， 再 单 击 链 接 Getting 
Started with Django。 如 果 你 看 不 懂 这 些 文档 ， 请 参阅 附录 C 提 供 的 建议 。 


20.2.13 在 Heroku 上 建立 数据 库 
为 建立 在 线 数据 库 ， 我 们 需要 再 次 执行 命令 migrate， 并 应 用 在 开发 期 间 生成 的 所 有 迁移 。 20 
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要 对 Heroku 项 目 执行 Django 和 Python 命令 ， 可 使 用 命令 heroku run。 下 面 演示 了 如 何 对 Heroku 部 
署 执 行 命令 migrate: 


@ (ll env)learning log$ heroku run python manage.py migrate 
@ Running “python manage.py migrate on afternoon-meadow-2775... Up, run.2435 
-- Snip-- 
四 Running migrations: 
-- Snip-- 
Applying learning logs.0001 initial... OK 
Applying learning logs.0002 entry... OK 
Applying learning logs.0003 topic user... OK 
Applying sessions.0001 initial... OK 
(1] env)learning log$ 


我 们 首先 执行 了 命令 heroku run python manage.py migrate( 见 @ ); Heroku 随 后 创建 一 个 终 
端 会 话 来 执行 命令 migrate ( 见 @ )。 在 人 @ 处 ，Django 应 用 默认 迁移 以 及 我 们 在 开发 “学 习 笔 记 ” 
期 间 生成 的 迁移 。 

现在 如 果 你 访问 这 个 部 署 的 应 用 程序 , 将 能 够 像 在 本 地 系统 上 一 样 使 用 它 。 然 而 , 你 看 不 到 
你 在 本 地 部 署 中 输入 的 任何 数据 , 因为 它们 没有 复制 到 在 线 服 务 器 。 一 种 通常 的 做 法 是 不 将 本 地 
数据 复制 到 在 线 部 署 中 ， 因 为 本 地 数据 通常 是 测试 数据 。 

你 可 以 分 享 “ 学 习 笔记 ”的 Heroku URL， 证 任何 人 都 可 以 使 用 它 。 在 下 一 他 ， 我 们 将 再 完 
成 几 个 任务 ， 以 结束 部 署 过 程 并 让 你 能 够 继续 开发 “学 习 笔 记 ”。 


20.2.14 ”改进 Heroku 部 署 


在 本 节 中 , 我 们 将 通过 创建 超级 用 户 来 改进 部 署 ， 就 像 在 本 地 一 样 。 我 们 还 将 让 这 个 项 目 更 
安全 : 将 DEBUG 设 置 为 False， 让 用 户 在 错误 消息 中 看 不 到 额外 的 信息 ， 以 防 他 们 使 用 这 些 信息 来 
攻击 服务 器 。 

1. 在 Heroku 上 创建 超级 用 户 

我 们 知道 可 使 用 命令 heroku run 来 执行 一 次 性 命令 ,但 也 可 这 样 执行 命令 : 在 连接 到 了 Heroku 
服务 器 的 情况 下 ， 使 用 命令 heroku run bash 来 打开 Bash 终 端 会 话 。Bash 是 众多 Linux 终 端 运行 的 
语言 。 我 们 将 使 用 Bash 终 端 会 话 来 创建 超级 用 户 ， 以 便 能 够 访问 在 线 应 用 程序 的 管理 网 站 : 


(11] env)learning log$ heroku run bash 
Running ‘bash” on afternoon-meadow-2775... Up, run.6244 
@~$1s 
learning log learning logs manage.py Procfile requirements.txt runtime.txt users 
staticfiles 
@ ~ $ python manage.py createsuperuser 
Username (leave blank to use 'u41907'): 11 admin 
Email address: 
Password: 
Password (again): 
Superuser created successfully. 
©@ ~$ exit 
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exit 
(11 env)learning log$ 


在 @ 处 ,我 们 执行 命令 ls， 以 查看 服务 器 上 有 哪些 文件 和 目录 ; 服务 器 包含 的 文件 和 目录 应 
该 与 本 地 系统 相同 。 你 可 以 像 遍 历 其 他 文件 系统 一 样 遍 历 这 个 文件 系统 。 


注意 ”即便 你 使 用 的 是 Windows 系 统 ， 也 应 使 用 这 里 列 出 的 命令 ( 如 1Ss 而 不 是 dir )， 因 为 你 正 通 
过 远程 连接 运行 一 个 Linux 终 端 。 


在 @ 处 , 我 们 执行 了 创建 超级 用 户 的 命令 , 它 像 第 18 章 在 本 地 系统 创建 超级 用 户 一 样 提示 你 
输入 相关 的 信息 。 在 这 个 终端 会 话 中 创建 超级 用 户 后 , 使 用 命令 exit 返 回 到 本 地 系统 的 终端 会 话 
( 见 @ )。 

现在 ， 你 可 以 在 在 线 应 用 程序 的 URL 末 尾 添加 /admin/ 来 登录 管理 网 站 了 。 对 我 而 言 ， 这 个 
URL 为 https://afternoon-meadow-2775.herokuapp.com/admin/。 

如 有 果 已 经 有 其 他 人 开始 使 用 这 个 项 目 , 别 忘 了 你 可 以 访问 他 们 的 所 有 数据 ! 千 万 别 不 把 这 当 
回 事 ， 否 则 用 户 就 不 会 再 将 其 数据 托付 给 你 了 。 

2. 在 Heroku 上 创建 对 用 户 友 好 的 URL 

你 可 能 希望 URL 更 友好 ， 比 https://afternoon-meadow-2775.herokuapp.com/ 更 好 记 。 为 此 ， 可 
只 需 使 用 一 个 命令 来 重 命名 应 用 程序 : 


(11 env)learning log$ heroku apps:rename learning-log 

Renaming afternoon-meadow-2775 to learning-log... done 
https://learning-log.herokuapp.com/ | https://git.heroku.com/learning-log.git 
Git remote heroku updated 

(11 env)learning log$ 


给 应 用 程序 命名 时 ， 可 使 用 字母 、 数 字 和 连 字 符 ; 你 想 怎 么 命名 应 用 程序 都 可 以 ， 只 要 指定 
的 名 称 未 被 别人 使 用 就 行 。 现 在 ,项 目的 URL 变 成 了 https://learning-log.herokuapp.com/; 使 用 以 
前 的 URL 再 也 无 法 访问 它 ， 命 令 apps:rename 将 整个 项 目 都 移 到 了 新 的 URL 处 。 


注意 ”你 使 用 Heroku 提 供 的 免费 服务 来 部 署 项 目 时 ， 如 果 项 目 在 指定 的 时 间 内 未 收 到 请 求 或 过 
于 活跃，Heroku 将 让 项 目 进入 休眠 状态 。 用 户 初次 访问 处 于 休眠 状态 的 网 站 时 ， 加 载 时 
间 将 更 长 ， 但 对 于 后 续 请 求 ， 服 务 器 的 响应 速度 将 更 快 。 这 就 是 Heroku 能 够 提供 免费 部 
署 的 原因 所 在 。 


20.2.15 ”确保 项 目的 安全 
当前 , 我 们 部 署 的 项 目 存在 一 个 严重 的 安全 问题 : settings.py 包 含 设置 DEBUG=True, 它 在 发 生 
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错误 时 显示 调试 信息 。 开 发 项 目 时 ， Django 的 错误 页 面向 你 显示 了 重要 的 调试 信息 ， 如 果 将 项 目 
部 署 到 服务 器 后 依然 保留 这 个 设置 , 将 给 攻击 者 提供 大 量 可 供 利用 的 信息 。 我 们 还 需 确保 任何 人 
都 无 法 看 到 这 些 信息 ， 也 不 能 冒充 项 目 托管 网 站 来 重 定 向 请 求 。 

下 面 来 修改 settings.py， 以 让 我 们 能 够 在 本 地 看 到 错误 消息 ， 但 部 署 到 服务 器 后 不 显示 任何 
错误 消息 : 


settings.py 


-- Ship-- 

# Heroku 设 置 

if os.getcwd() '/app': 
-- Snip-- 
# 让 request.is secure() 承 认 X-Forwarded-Proto 头 
SECURE PROXY SSL HEADER = ('HTTP X FORWARDED PROTO', 'https') 


# 只 允许 Heroku 托 管 这 个 项 目 
@ ALLOWED HOSTS = [ "learning-log.herokuapp.com '] 


@ DEBUG = False 


# 静态 资产 配置 


-- Snip-- 


我 们 只 需 做 两 方面 的 修改 。 在 @ 处 ,修改 ALLOWED HOSTS， 只 人 允许 Heroku 托 管 这 个 项 目 。 你 需 
要 使 用 应 用 程序 的 名 称 ， 可 以 是 Heroku 提 供 的 名 称 (如 afternoon-meadow-2775.herokuapp.com )， 
也 可 以 是 你 选择 的 名 称 。 在 @@ 处 ， 我 们 将 DEBUG 设 置 为 False， 让 Django 不 在 错误 发 生 时 显示 敏感 


信息 Le 


20.2.16 ”提交 并 推送 修改 


现在 需要 将 对 settings.py 所 做 的 修改 提交 到 Git 仓 库 ， 表 将 修改 推送 到 Heroku。 下 面 的 终端 会 
话 演示 了 这 个 过 程 : 


@ (ll env)learning log$ git commit -am "Set DEBUG=False for Heroku." 
[master 081f635] Set DEBUG=False for Heroku. 
1 file changed, 4 insertions(+), 2 deletions(-) 

@ (ll env)learning log$ git status 
# On branch master 
nothing to commit, working directory clean 
(1] env)learning log$ 


我 们 执行 命令 git commit， 并 指定 了 一 条 简短 而 具有 描述 性 的 提交 消息 ( 见 @ )。 别 忘 了 ， 标 
志 -ami 上 Git 提 交 所 有 修改 过 的 文件 ， 并 记录 一 条 日 志 消 息 。Git 找 出 唯一 一 个 修改 过 的 文件 , 并 将 
所 做 的 修改 提交 到 仓库 。 
@ 处 显示 的 状态 表明 我 们 在 仓库 的 分 支 master 上 工作 ， 当 前 没有 任何 未 提交 的 修改 。 推 送 到 
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Heroku 之 前 ,必须 检查 状态 并 看 到 刚才 所 说 的 消息 。 如 果 你 没有 看 到 这 样 的 消息 , 说 明 有 未 提交 
的 修改 ， 而 这 些 修 改 将 不 会 推送 到 服务 器 。 在 这 种 情况 下 ， 可 尝试 再 次 执行 命令 commit ， 但 如 果 
你 不 知道 该 如 何 解 决 这 个 问题 ， 请 阅读 附录 D ， 更 深入 地 了 解 Git 的 用 法 。 

下 面 来 将 修改 后 的 仓库 推送 到 Heroku: 


(11 env)learning log$ git push heroku master 


-- Snip-- 
remote: ----- > Python app detected 
remote: ----- > Installing dependencies with pip 
SNnip- 
remote: ----- > Launching... done, v8 
remote: https://learning-log.herokuapp.com/ deployed to Heroku 
remote: Verifying deploy.... done. 


To https://git.heroku.com/learning-log.git 
4c9d111..ef65d2b master -> master 
(1] env)learning log$ 


Heroku 发 现 仓库 发 生 了 变化 , 因此 重建 项 目 , 确保 所 有 的 修改 都 已 生效 。 它 不 会 重建 数据 库 ， 
因此 这 次 无 需 执行 命令 migrate。 

现在 要 核实 部 署 更 安全 了 ,请 输入 项 目的 URL， 并 在 末尾 加 上 我 们 未 定义 的 扩展 。 例如， 尝 
试 访问 http://learning-log.herokuapp.com/letmein/。 你 将 看 到 一 个 通用 的 错误 页 面 ， 它 没有 泄露 任 
何 有 关 该 项 目的 具体 信息 。 如 果 你 尝试 向 本 地 的 “学 习 笔记 ”发 出 同样 的 请 求 一 一 输入 URL 
http://localhost:8000/letmein/， 你 将 看 到 完整 的 Django 错 误 页 面 。 这 样 的 结果 非常 理想 ， 你 接着 开 
发 这 个 项 目 时 ， 将 看 到 信息 丰富 的 错误 消息 ， 但 用 户 看 不 到 有 关 项 目 代码 的 重要 信息 。 


20.2.17 ”创建 自 定义 错误 页 面 


在 第 19 章 ,我 们 对 “学 习 笔 记 ” 进 行 了 配置 , 使 其 在 用 户 请 求 不 属于 他 的 主题 或 条 目 时 返回 
404 错 误 。 你 可 能 还 遇 到 过 一 些 500 错 误 ( 内 部 错误 )。404 错 误 通 常 意味 着 你 的 Django 代 码 是 正确 
的 , 但 请 求 的 对 象 不 存在 。 500 错 误 通 常 意味 着 你 编写 的 代码 有 问题 , 如 views.py 中 的 函数 有 问题 。 
当前 ,在 这 两 种 情况 下 ，Django 都 返回 通用 的 错误 页 面 ， 但 我 们 可 以 编写 外 观 与 “学 习 笔 记 ”一 
致 的 404 和 500 错 误 页 面 模板 。 这 些 模板 必须 放 在 根 模板 目录 中 。 

1. 创建 自 定义 模板 

在 文件 夹 learning log/learning_ log 中， 新 建 一 个 文件 来 ， 并 将 其 命名 为 templates; 再 在 这 个 
文件 夹 中 新 建 一 个 名 为 404.html 的 文件 ， 并 在 其 中 输入 如 下 内 容 : 


404.html 


{% extends "learning logs/base.html" %} 


{% block header %} 
<h2>The item you requested is not available. (404)</h2> 
{% endblock header %} 
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这 个 简单 的 模板 指定 了 通用 的 404 错 误 页 面包 含 的 信息 ， 并 且 该 页 面 的 外 观 与 网 站 的 其 他 部 
分 一 致 。 
再 创建 一 个 名 为 500.html 的 文件 ， 并 在 其 中 输入 如 下 代码 : 


500.html 


{% extends "learning logs/base.html" %} 


{% block header %} 


<h2>There has been an internal error. (500)</h2> 
{% endblock header %} 


这 些 新 文件 要 求 对 settings.py 做 细微 的 修改 : 
settings.py 


-- Shnip-- 
TEMPLATES = [ 
{ 
'BACKEND': “django.template.backends.django.DJjangoTemplates ， 
'DIRS': [os.path.join(BASE DIR, 'learning log/templates')], 
'APP_DIRS': True, 
-- Ship-- 
外 
| 


-- SNip-- 


这 项 修改 让 Django 在 根 模板 目录 中 查找 错误 页 面 模板 。 

2. 在 本 地 查看 错误 页 面 

在 将 项 目 推 送 到 Heroku 之 前 , 如 果 你 要 在 本 地 查看 错误 页 面 是 什么 样 的 , 首先 需要 在 本 地 设 
置 中 设置 Debug=False, 以 禁止 显示 默认 的 Django 调 试 页 面 。 为 此 , 可 对 settings.py 做 如 下 修改 ( 请 
确保 你 修改 的 是 用 于 本 地 环境 的 settings.py 部 分 ， 而 不 是 用 于 Heroku 的 部 分 ): 


settings.py 


# 安全 : 不 要 在 在 线 环境 中 启用 调试 | 
DEBUG = False 


ALLOWED HOSTS = ['localhost'] 


-- SNip-- 


DEBUG 被 设置 为 False 时 ， 你 必须 在 ALLONED_ HOSTS 中 指定 一 个 主机 。 现 在 ， 请 求 一 个 不 属于 你 
的 主题 或 条 目 ， 以 查看 404 错 误 页 面 ; 请 求 不 存在 的 URL ( 如 localhost:8000/letmein/ )， 以 查看 500 
错误 页 面 。 
查看 错误 页 面 后 , 将 DEBUG 重 新 设置 为 True, 以 方便 你 进一步 开发 “学 习 笔记 ”。( 在 settings.py 
中 用 于 Heroku 部 署 的 部 分 中 ， 确 保 DEBUG 依 然 被 设置 为 False )。 
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注意 500 错 误 页 面 不 会 显示 任何 有 关 当 前 用 户 的 信息 ， 因 为 发 生 服 务 器 错误 时 ，Django 不 会 通 
过 响应 发 送 任何 上 下 文 信息 。 


3. 将 修改 推送 到 Heroku 
现在 需要 提交 对 模板 所 做 的 修改 ， 并 将 这 些 修 改 推送 到 Heroku: 


@ (]1 env)learn 
@ (ll env)learn 


ing log$ git add . 
ing log$ git commit -am "Added custom 404 and 500 error pages." 


3 files changed, 15 insertions(+), 10 deletions(-) 
create mode 100644 learning log/templates/404.html 


create mode 
©@ (ll env)learn 
-- Snip-- 


100644 learning log/templates/500.html 


ng log$ git push heroku master 


remote: Verifying deploy.... done. 


To https://git 


.heroku.com/learning-log.git 


2b34ca1..a64d8d3 master -> master 


(11 env)learni 


ng log$ 


在 @ 人 处 ,我 们 执行 了 命令 git add， 这 是 因为 我 们 在 项 目 中 创建 了 一 些 新 文件 ， 因 此 需要 让 


Git 跟 踪 这 些 文件 


。 然后 , 我 们 提交 所 做 的 修改 ( 见 @ ), 并 将 修改 后 的 项 目 推 送 到 Heroku ( 见 @ )。 


现在 ， 错 误 页 面 出 现时 ， 其 样式 应 该 与 网 站 的 其 他 部 分 一 致 ， 这 样 在 发 生 错误 时 ， 用 户 将 不 


会 感到 突 元 。 


4. 使 用 方法 get object or 404() 

现在 ， 如 果 用 户 手 工 请 求 不 存在 的 主题 或 条 目 ， 将 导致 500 错 误 。Django 尝 试 泻 染 请 求 的 页 
面 , 但 没有 足够 的 信息 来 完成 这 项 任务 ,进而 引发 500 错 误 。 对 于 这 种 情形 , 将 其 视 为 404 错 误 更 
合适 , 为 此 可 使 用 Django 快 捷 函 数 get_ object _or 404()。 这 个 函数 尝试 从 数据 库 获 取 请 求 的 对 象 ， 
如 果 这 个 对 象 不 存在 ， 就 引发 404 异 常 。 我 们 在 views.py 中 导入 这 个 函数 ,并 用 它 替 换 函 数 get(): 


views.py 


-- SNip-- 


from django.shortcuts import render, get object or 404 
from django.http import HttpResponseRedirect, Http404 


=- SNip-- 


@login required 

def topic(request, topic id): 
'" "显示 单个 主题 及 其 所 有 的 条 目 """ 
topic = get object or 404(Topic, id=topic id) 
# 确定 主题 属于 当前 用 户 


-- Snip-- 


现在 ， 如 果 你 请 求 不 存在 的 主题 ( 例如， 使 用 URL http://localhost:8000/topics/999999/ )， 将 


看 到 404 错 误 页 面 


。 为 部 署 这 里 所 做 的 修改 ， 再 次 提交 ， 并 将 项 目 推送 到 Heroku。 
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20.2.18 ”继续 开发 


将 项 目 “ 学 习 笔 记 ” 推 送 到 服务 器 后 ， 你 可 能 想 进一步 开发 它 或 开发 要 部 署 的 其 他 项 目 。 更 
新 项 目的 过 程 几乎 完全 相同 。 

首先 ， 你 对 本 地 项 目 做 必要 的 修改 。 如 果 在 修改 过 程 中 创建 了 新 文件 ， 使 用 命令 git add . 
( 千 万 别 忘 记 这 个 命令 末尾 的 句点 ) 将 它们 加 入 到 Git 仓 库 中 。 如 果 有 修改 要 求 迁 移 数据 库 ， 也 需 
要 执行 这 个 命令 ， 因 为 每 个 迁移 都 将 生成 新 的 迁移 文件 。 

然后 ， 使 用 命令 git commit -am "commit message" 将 修改 提交 到 仓库 ， 再 使 用 命令 git push 
heroku master 将 修改 推送 到 Heroku。 如 果 你 在 本 地 迁移 了 数据 库 ， 也 需要 迁移 在 线 数据 库 。 为 
此 ， 你 可 以 使 用 一 次 性 命令 neroku run python manage.py migrate， 也 可 使 用 heroku run bash 打 
开 一 个 远程 终端 会 话 ， 并 在 其 中 执行 命令 python manage.py migrate。 然 后 访问 在 线 项 目 ,确认 
你 期 望 看 到 的 修改 已 生效 。 

在 这 个 过 程 中 很 容易 犯错 ,因此 看 到 错误 时 不 要 大 惊 小 怪 。 如 果 代 码 不 能 正确 地 工作 ， 请 重 
新 审视 所 做 的 工作 ,尝试 找 出 其 中 的 错误 。 如 果 找 不 出 错误 , 或 者 不 知道 如 何 撤销 错误 ,请 参阅 
附录 C 中 有 关 如 何 寻求 帮助 的 建议 。 不 要 着 于 去 寻求 帮助 : 每 个 学 习 开 发 项 目的 人 都 可 能 遇 到 过 
你 面临 的 问题 ， 因 此 总 有 人 乐意 伸 出 援手 。 通 过 解决 遇 到 的 每 个 问题 ， 可 让 你 的 技能 稳步 提高 ， 
最 终 能 够 开发 可 靠 而 有 意义 的 项 目 ， 还 能 解决 别人 遇 到 的 问题 。 


20.2.19 设置 SECRET_KEY 


Dijango 根 据 settings.py 中 设置 SECRET_KEY 的 值 来 实现 大 量 的 安全 协议 。 在 这 个 项 目 中 , 我 们 提 
交 到 仓库 的 设置 文件 包含 设置 SECRET_KEY。 对 于 一 个 练习 项 目 而 言 , 这 足够 了 , 但 对 于 生产 网 站 ， 
应 更 细致 地 处 理 设置 SECRET_KEY。 如 果 你 创建 的 项 目的 用 途 很 重要 ,务必 研究 如 何 更 安全 地 处 理 
设置 SECRET KEY。 


20.2.20 将 项 目 从 Heroku 删除 


一 个 不 错 的 练习 是 , 使 用 同一 个 项 目 或 一 系列 小 项 目 执行 部 署 过 程 多 次 , 直到 对 部 署 过 程 了 
如 指 掌 。 然 而 ， 你 需要 知道 如 何 删除 部 署 的 项 目 。Heroku 可 能 还 限制 了 你 可 免费 托管 的 项 目 数 ， 
另外 ， 你 也 不 希望 让 自己 的 账户 中 塞 满 大 量 的 练习 项 目 。 

在 Heroku 网 站 ( https://heroku.com/ ) 登录 后 ， 你 将 被 重 定 向 到 一 个 页 面 ， 其 中 列 出 了 你 托管 
的 所 有 项 目 。 单 击 要 删除 的 项 目 ， 你 将 看 到 另 一 个 页 面 ， 其 中 显示 了 有 关 这 个 项 目的 信息 。 单 击 
链接 Settings， 再 向 下 滚动 ， 找 到 用 于 删除 项 目的 链接 并 单 击 它 。 这 种 操作 是 不 可 撤销 的 ， 因 此 
Heroku 让 你 手工 输入 要 删除 的 项 目的 名 称 ， 以 确认 你 确实 要 删除 它 。 

如 果 你 喜欢 在 终端 中 工作 ， 也 可 使 用 命令 destroy 来 删除 项 目 : 


(11_env)learning log$ heroku apps:destroy --app appname 
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其 中 appname 是 要 删除 的 项 目的 名 称 ， 可 能 类 似 于 afternoon-meadow-2775， 也 可 能 类 似 于 
learning-log( 如 果 你 重 命名 了 项 目 )。 你 将 被 要 求 再 次 输入 项 目 名 ， 以 确认 你 确实 要 删除 它 。 


注意 ”删除 Heroku 上 的 项 目 对 本 地 项 目 没有 任何 影响 。 如 果 没 有 人 使 用 你 部 署 的 项 目 ， 就 尽管 
去 练习 部 署 过 程 好 了 ， 在 Heroku 删 除 项 目 再 重新 部 署 完全 合情合理 。 


动手 试 一 斌 


20-3 在 线 博 客 : 将 你 一 直 在 开发 的 项 目 Blog 部 署 到 Heroku。 确 保 将 DEBUG 设置 为 
False， 并 修改 设置 ALLOWED HOSTS， 让 部 署 相当 安全 。 

20-4 在 更 多 的 情况 下 显示 404 错误 页 面 : 在 视图 函数 new entry() 和 edit entry() 
中 ， 也 使 用 函数 get object or 404()。 完 成 这 些 修改 后 进行 测试 : 输入 类 似 于 
http://localhost:8000/mnew_entry/99999/ 的 URL， 确 认 你 能 够 看 到 404 错误 页 面 。 


20-S 扩展 “学 习 笔记 ”: 在 “学 习 笔 记 ” 中 添加 一 项 功能 ， 将 修改 推送 到 在 线 部 署 。 
尝试 做 一 项 简单 的 修改 ,如 在 主页 中 对 项 目 作 更 详细 的 描述 ; 再 尝试 添加 一 项 更 高 级 的 
功能 ， 如 让 用 户 能 够 将 主题 设置 为 公开 的 。 为 此 ， 需 要 在 模型 Topic 中 添加 一 个 名 为 
public 的 属性 (其 默认 值 为 False ), 并 在 new topic 页 面 中 添加 一 个 表单 元 素 ， 让 用 户 
能 够 将 私有 主题 改 为 公开 的 。 然 后 ， 你 需要 迁移 项 目 ， 并 修改 views.py， 让 未 登录 的 用 
户 也 可 以 看 到 所 有 公开 的 主题 。 将 修改 推送 到 Heroku 后 ， 别 忘 了 迁移 在 线 数据 库 。 


20.3 小 结 


在 本 章 中 ,你 学 习 了 如 何 使 用 Bootstrap 库 和 应 用 程序 django-bootstrap3 赋 予 应 用 程序 简单 而 专 
业 的 外 观 。 使 用 Bootstrap 意 味 着 无 论 用 户 使 用 哪 种 设备 来 访问 你 的 项 目 ,， 你 选择 的 样式 都 将 实现 
几乎 相同 的 效果 。 

你 学 习 了 Bootstrap 的 模板 ， 并 使 用 模板 Static top navbar 赋 予 了 “学 习 笔 记 ” 简 单 的 外 观 。 
你 学 习 了 如 何 使 用 jumbotron 来 突出 主页 中 的 消息 ， 还 学 习 了 如 何 给 网 站 的 所 有 网 页 设置 一 致 的 
样式 。 

在 本 章 的 最 后 一 部 分 , 你 学 习 了 如 何 将 项 目 部 署 到 Heroku 的 服务 器 , 让 任何 人 都 能 够 访问 它 。 
你 创建 了 一 个 Heroku 账 户 ， 并 安装 了 一 些 帮 助 管理 部 署 过 程 的 工具 。 你 使 用 Git 将 能 够 正确 运行 
的 项 目 提交 到 一 个 仓库 ， 再 将 这 个 仓库 推送 到 Heroku 的 服务 器 。 最 后 ， 你 将 DEBUG 设 置 为 False， 
以 确保 在 线 服务 器 上 应 用 程序 的 安全 。 

至 此 , 开发 完了 项 目 “ 学 习 笔记 ”后 , 你 可 以 自己 动手 开发 项 目 了 。 请 先 让 项 目 尽 可 能 简单 ， 
确定 它 能 正确 运行 后 ， 再 添加 复杂 的 功能 。 愿 你 学 习 愉 快 ， 开 发 项 目 时 有 好 运 相伴 ! 


安装 Python 


Python 有 多 个 不 同 的 版 本 , 而 在 各 种 操作 系统 中 安装 它 的 方式 有 
很 多 。 如 果 第 1 章 介绍 的 方法 不 管用 ， 或 者 你 要 安装 非 系 统 自 带 的 
Python 版 本 ， 这 个 附录 可 提供 帮助 。 


A.1 在 Linux 系统 中 安装 Python 


几乎 所 有 Linux 系 统 都 默认 安装 了 Python， 但 你 可 能 想 使 用 非 默 认 版 本 。 如 果 是 这 样 ， 请 首 
先 确定 已 安装 的 Python 版 本 。 


A.1.1 确定 已 安装 的 版 本 


打开 一 个 终端 窗口 ， 并 执行 如 下 命令 : 


python --version 
Python 2.7.6 


输出 表明 默认 版 本 是 2.7.6， 但 系统 可 能 还 安装 了 一 个 Python 3 版 本 。 为 核实 这 一 点 ， 请 执行 
如 下 命令 : 


python3 --version 
Python 3.5.0 


输出 表明 也 安装 了 Python 3.5.0。 安 装 新 版 本 前 ， 有 必要 执行 上 述 两 个 命令 。 
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A.1.2 在 Linux 系统 中 安装 Python 3 


如 果 你 的 系统 没有 安装 Python 3 ,或 者 你 想 安 装 较 新 的 Python 3 版 本 , 只 需 执行 几 个 命令 即 可 。 
我 们 使 用 一 个 名 为 deadsnakes 的 包 ， 它 让 安装 多 个 Python 版 本 变 得 很 容易 : 


$ sudo add-apt-repository ppa:fkrull/deadsnakes 
$ sudo apt-get update 
$ sudo apt-get install python3.5 


这 些 命 令 在 你 的 系统 中 安装 Python 3.5。 下 面 的 命令 启动 一 个 运行 Python 3.5 的 终端 会 话 : 


$ python3.5 
>>> 


配置 文本 编辑 器 使 其 使 用 Python 3 以 及 从 终端 运行 程序 时 ， 也 需要 用 到 这 个 命令 。 
A.2 在 OS X 系 统 中 安装 Python 


大 多 数 OS X 系 统 都 安装 了 Python, 但 你 可 能 想 使 用 非 默认 版 本 。 如 果 是 这 样 ， 请 首先 确定 已 
安装 了 哪个 版 本 的 Python。 


A.2.1 确定 已 安装 的 版 本 


打开 一 个 终端 窗口 ， 并 执行 如 下 命令 : 


$ python --version 
Python 2.7.6 


你 还 应 尝试 执行 命令 python3 --version。 执 行 这 个 命令 时 ， 可 能 会 出 现 错误 消息 ， 但 若 要 确 
定安 装 了 哪些 Python 版 本 ， 有 必要 执行 这 个 命令 。 


A.2.2 ”使 用 Homebrew 来 安装 Python 3 


如 果 你 的 系统 只 安装 了 Python 2 , 或 者 已 安装 的 Python 3 版 本 较 旧 , 可 使 用 一 个 名 为 Homebrew 
的 包 来 安装 最 新 的 Python 3 版 本 。 

1. 安装 Homebrew 

Homebrew 依 赖 于 Apple 包 Xcode， 因 此 请 打开 一 个 终端 窗口 并 执行 如 下 命 邻 : 


$ xcode-select --install 


在 不 断 出 现 的 确认 对 话 框 中 都 单 击 OK 按 钮 (根据 网 络 连 接 的 速度 ， 这 可 能 会 花 一 些 时 间 )。 
接 下 来 安装 Homebrew: 


$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" 
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个 命令 可 在 Homebrew 网 站 ( http://brew.sh/ ) 的 首页 找到 。 在 curl -fsSL 和 URL 之 间 ， 务 必 


注意 ”这 个 命令 中 的 -e 让 Ruby (Homebrew 就 是 使 用 这 种 编程 语言 编写 的 ) 执行 下 载 的 代码 。 除 
非 来 源 是 你 信任 的 ， 否 则 不 要 运行 这 样 的 命令 。 


为 确认 正确 地 安装 了 Homebrew， 请 执行 如 下 命令 ; 


$ brew doctor 
Your system is ready to brew. 


上 述 输 出 表明 你 可 以 使 用 Homebrew 来 安装 Python 包 了 。 
2. 安装 Python 3 
为 安装 最 新 的 Python 3 版 本 ， 请 执行 如 下 命令 : 


$ brew install python3 


下 面 来 检查 使 用 这 个 命令 安装 的 是 哪个 版 本 : 


$ python3 --version 
Python 3.5.0 
$ 


现在 ， 你 可 以 使 用 命令 python3 来 启动 Python 3 终端 会 话 了 ， 还 可 使 用 命令 python3 来 配置 文 
本 编辑 器 ， 使 其 使 用 Python 3 而 不 是 Python 2 来 运行 Python 程序 。 


A.3 在 Windows 系统 中 安装 Python 


Windows 系 统 默认 未 安装 Python ， 但 有 必要 检查 系统 是 否 安装 了 它 。 为 此 ， 按 住 Shift 键 并 右 


击 桌面 ， 再 


选择 “在 此 处 打开 命令 窗口 ”来 打开 一 个 终端 窗口 。 你 也 可 以 在 开始 菜单 中 执行 命令 


command。 在 打开 的 终端 窗口 中 ， 执 行 如 下 命令 : 


> python --version 
Python 3.5.0 


如 果 你 看 到 了 类 似 于 上 面 的 输出 ， 说 明 已 安装 了 Python， 但 你 可 能 想 安 装 更 新 的 版 本 。 如 引 
看 到 一 条 错误 消息 ， 就 说 明 你 需要 下 载 并 安装 Python。 


‘i 


A.3.1 在 Windows 系统 中 安装 Python 3 


访问 http://python.org/downloads/， 并 单 击 你 要 安装 的 Python 版 本 。 下 载 安装 程序 ， 并 在 运 
行 它 时 选择 复 选 框 Add Python to PATH。 这 让 你 不 用 手工 修改 系统 的 环境 变量 ， 在 执行 命令 
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python 时 也 无 需 指定 其 完整 路 径 。 安 装 Python 后 ， 打 开 一 个 新 的 终端 窗口 ， 并 在 其 中 执行 命令 
python --version。 如 果 没 有 报错 ， 就 说 明 Python 安 装 好 了 。 


A.3.2 查找 Python 解释 器 


如 果 不 能 执行 简单 命令 python， 你 就 需要 告诉 Windows 去 哪里 查找 Python 解释 器 。 要 确定 
python 解释 器 的 位 置 ， 请 打开 C 盘 ， 并 在 其 中 查找 名 称 以 Python 打 头 的 文件 夹 ( 要 找到 这 样 的 广 
件 夹 ， 你 可 能 需要 在 Windows 资 源 管理 器 中 的 搜索 栏 中 输入 单词 python ) 打开 这 个 文件 夹 ， 并 碍 
找 名 称 为 python ( 全 部 小 写 ) 的 文件 。 右 击 这 个 文件 并 选择 “属性 "， 你 将 在 “位 置 :” 右 边 看 到 
它 的 路 径 。 

在 终端 窗口 中 ， 使 用 该 路 径 来 确定 刚 安装 的 Python 版 本 : 


$ C:\\Python35\python --version 
Python 3.5.0 


A.3.3 将 Python 添加 到 环境 变量 Path 中 


如 果 每 次 启动 Python 终端 时 都 需要 输入 完整 的 路 径 ， 那 就 太 讨 大 了 ; 有 鉴于 此 ,我 们 将 在 系 
统 中 添加 这 个 路 径 ， 证 你 只 需 使 用 命令 python 即 可 。 如 果 你 在 安装 Python 时 选择 了 复 选 枉 Add 
Python to PATH,， 可 跳 过 这 一 步 。 打 开 控 制 面板 并 单 击 “系统 和 安全 ”, 再 单 击 “系统 ”。 单 击 “ 高 
级 系统 设置 "， 在 打开 的 窗口 中 单 击 按钮 “环境 变量 ”。 

在 “系统 变量 ”部 分 ， 找 到 并 单 击 变量 Path， 再 单 击 按钮 “编辑 ”。 在 出 现 的 对 话 框 中 ,， 单 
击 “变量 值 ”， 并 使 用 右 箭头 键 滚 到 最 右边 。 千 万 不 要 履 盖 变量 原来 的 值 ， 如 果 你 不 小 心 这 样 做 
了 , 单 击 “ 取 消 ” 按钮 , 再 重复 前 面 的 步骤 。 在 变量 值 的 末尾 添加 一 个 分 号 , 再 添加 文件 python.exe 
的 路 径 : 


WSystemRoot%\system32\...\System32\WindowsPowerShell\v1.0\;C:\Python34 


关闭 终端 窗口 ， 再 打开 一 个 新 的 终端 窗口 。 这 将 在 终端 会 话 中 加 载 变 量 Path 的 新 值 。 现 在 当 
你 执行 命令 python --version 时 ， 将 看 到 刚才 在 变量 path 中 设置 的 Python 版 本 。 现 在 ， 你 只 需 在 
命令 提示 符 下 输入 python 并 按 回 车 ， 就 可 启动 Python 终端 会 话 了 。 


A.4 Python 关键 字 和 内 置 函 数 


Python 包 含 一 系列 关键 字 和 内 置 函数 ， 给 变量 命名 时 ， 知 道 这 些 关 键 字 和 内 置 函 数 很 重要 。 
编程 中 面临 的 一 个 挑战 是 给 变量 指定 合适 的 名 称 , 变量 名 可 以 是 任何 东西 ,只 要 它 长 短 合适 并 描 
述 了 变量 的 作用 。 同 时 ， 不 能 将 Python 关键 字 用 作 变 量 名 ; 也 不 应 将 Python 内 置 函 数 的 名 称 用 作 
变量 名 ， 否 则 将 覆盖 相应 的 内 置 函 数 。 

本 节 将 列 出 Python 关 键 字 和 内 置 函数 的 名 称 ， 让 你 知道 应 避免 使 用 哪些 变量 名 。 
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A.4.1 ”Python 关键 字 
下 面 的 关键 字 都 有 特殊 含义 ， 如 果 你 将 它们 用 作 变 量 名 ， 将 引发 错误 : 


False class finally is return 
None continue for lambda try 
True def from nonlocal while 
and del global not with 
as elif i or yield 
assert else import pass 

break except in raise 


A.4.2 Python 内 置 函数 
将 内 置 函 数 名 用 作 变 量 名 时 ， 不 会 导致 错误 ,但 将 覆盖 这 些 函 数 的 行为 : 


abs() divmod() input() open() staticmethod() 
all() enumerate() int() ord() str() 

any() eval() jisinstance() pow() sum() 
basestring() execfile() issubclass() print() super() 
bin() file() iter() property() tuple() 
bool() filter() len() range() type() 
bytearray() float() list() raw input() unichr() 
callable() format() locals() reduce() unicode() 
chr() frozenset() long() reload() vars() 
classmethod() getattr() map() repr() xrange() 
cmp() globals() max() reversed()zip() Zip() 
compile() hasattr() memoryview() round() _ import () 
complex() hash( min() set() apply() 
delattr() help( next() setattr() buffer() 
dict() hex() object() slice() coercel() 
dir() id() oct() sorted() intern() 


注意 在 Python 2.7 中 ，print 是 关键 字 而 不 是 函数 。 另 外 ，Python 3 没有 内 置 函数 unicode()。 这 
两 个 单词 都 不 应 用 作 变 量 名 。 


文本 编辑 器 


程序 员 花 大 量 时 间 来 编写 、 阅 读 和 编辑 代码 ， 因 此 使 用 的 文本 
编辑 器 必须 能 够 尽 可 能 提高 完成 这 种 工作 的 效率 。 高 效 的 编辑 器 应 
突出 代码 的 结构 ， 让 你 在 编写 代码 时 就 能 够 发 现 常见 的 bug。 它 还 应 
包含 自动 缩 进 功能 、 显 示 代 码 长 度 的 标志 以 及 用 于 执行 常见 操作 的 
快捷 键 。 

如 果 你 是 编程 新 手 , 应 使 用 具备 上 述 功能 但 学 习 起 来 又 不 难 的 编 
辑 器 。 另外 ,你 最 好 对 更 高 级 的 编辑 器 有 所 了 解 , 这 样 就 知道 何 时 该 
考虑 升级 编辑 器 了 。 

对 于 每 种 主要 的 操作 系统 ,我 们 都 将 介绍 一 款 符合 上 述 条 件 的 纺 
辑 器 : 使 用 Linux 或 Windows 系 统 的 初学 者 可 使 用 Geany; 使 用 OS X 的 初学 者 可 使 用 Sublime 
Text( 它 在 Linux 和 Windows 系 统 中 的 效果 也 很 好 )。 我 们 还 将 介绍 Python 自 带 的 编辑 器 IDLE。 
最 后 ， 我 们 将 介绍 Emacs 和 vim， 这 是 两 款 高 级 编辑 器 ， 随 着 你 不 断 地 学 习 编 程 ， 经 常会 听 
到 有 人 提起 它们 。 我 们 将 把 hello world.py 作 为 示例 程序 ， 在 上 述 每 款 编辑 器 中 运行 它 。 


B.1 Geany 


Geany 是 一 款 简单 的 编辑 器 ， 你 可 以 在 其 中 直接 运行 几乎 任何 程序 。 它 还 在 一 个 终端 窗口 中 
显示 程序 的 输出 ， 这 有 助 于 你 逐渐 习惯 使 用 终端 。 


B.1.1 在 Linux 系统 中 安装 Geany 


在 大 多 数 Linux 系 统 中 ， 安 装 Geany 只 需 一 个 命令 : 


$ sudo apt-get install geany 


如 果 你 的 系统 安装 了 多 个 版 本 的 Python ， 就 必须 配置 Geany， 使 其 使 用 正确 的 版 本 。 启 动 
Geany， 选 择 菜 单 File 》 Save As， 将 当前 的 空 文件 保存 为 hello_worldpy， 再 在 编辑 窗口 中 输入 下 
面 一 行 代 码 : 


print("Hello Python world!") 
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选择 菜单 Build ”Set Build Commands ， 你 将 看 到 文字 Compile 和 Execute， 它 们 旁边 都 有 一 个 
命令 。 默 认 情 况 下 ， 这 两 个 命令 都 是 python， 要 让 Geany 使 用 命令 python3 ， 必 须 做 相应 的 修改 。 
将 编译 命令 修改 成 下 面 这 样 : 


三 


python3 -m py_compile "%f" 


你 必须 完全 按 这 里 显示 的 这 样 输出 这 个 命令 ， 确 保 空格 和 大 小 写 都 完全 相同 。 
将 执行 命令 修改 成 下 面 这 样 : 


python3 "%f" 


同样 ， 务 必 确 保 空 格 和 大 小 写 都 完全 与 显示 的 相同 。 
B.1.2 在 Windows 系统 中 安装 Geany 


要 下 载 Windows Greany 安 装 程序 ， 可 访问 http:/geany.org/， 单 击 Download 下 的 Releases， 找 
到 安装 程序 geany-1.2$_setup.exe 或 类 似 的 文件 。 下 载 安装 程序 后 , 运行 它 并 接受 所 有 的 默认 设置 。 

启动 Geany， 选 择 菜 单 File 》 Save As， 将 当前 的 空 文件 保存 为 hello_world.py， 再 在 编辑 窗口 
中 输入 下 面 一 行 代码 : 


print("Hello Python world!") 


现在 选择 菜单 Build > Set Build Commands ， 你 将 看 到 文字 Compile 和 Execute， 它 们 旁边 都 有 
一 个 命令 。 默 认 情 况 下 ， 这 两 个 命令 都 是 python ( 全 部 小 写 ), 但 Geany 不 知道 这 个 命令 位 于 系统 
的 什么 地 方 。 你 需要 添加 启动 终端 会 话 时 使 用 的 路 径 ( 如 果 你 按 附录 A 描述 的 那样 设置 了 变量 
Path， 可 跳 过 这 些 步 又 )。 在 编译 命令 和 执行 命令 中 ， 添 加 命令 python 所 在 的 驱动 器 和 文件 夹 。 
编译 命令 应 类 似 于 下 面 这 样 : 


C:\Python35\python -m py_compile "%f" 


在 你 的 系统 上 ， 路 径 可 能 稍 有 不 同 ， 但 你 必须 确保 空格 和 大 小 写 都 与 这 里 显示 的 完全 相同 。 
执行 命令 应 类 似 于 下 面 这 样 : 


C:\Python35\python "%f" 


同样 ， 务 必 确 保 空格 和 大 小 写 都 与 这 里 显示 的 完全 相同 。 正 确 地 设置 这 些 命令 后 ， 单 击 OK 
按钮 。 现 在 ， 你 应 该 能 够 成 功 地 运行 程序 了 。 


B.1.3 ”在 Geany 中 运行 Python 程序 


在 Geany 中 运行 程序 的 方式 有 三 种 。 为 运行 程序 hello _ world.py， 可 选择 菜单 Build 》 Execute、 
单 击 由 两 个 齿轮 组 成 的 图 标 或 按 F5。 运行 hello world.py 时 , 将 弹出 一 个 终端 窗口 ,其 中 包含 如 下 
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输出 : 


Hello Python world! 


(program exited with code: 0) 
Press return to continue 


B.1.4 定制 Geany 的 设置 


下 面 来 定制 本 附录 开头 提 到 的 功能 ， 尽 可 能 提高 Geany 的 效率 。 

1. 将 制 表 符 转换 为 空 

在 代码 中 混合 使 用 制 表 符 和 空格 可 能 会 给 Python 程序 带 来 极 难 诊断 的 问题 。 为 在 Geany 中 查 
看 缩 进 设置 , 选择 荣 单 Edit 》 Preferences, 再 依次 单 击 Editor 和 Indentation。 将 制 表 符 宽度 设置 为 4， 
并 将 Type 设置 为 Spaces。 

如 果 你 在 程序 中 混合 使 用 了 标识 符 和 空格 ， 可 选择 菜单 Document Replace Tabs by Spaces 
(“ 蔡 换 制 表 符 为 空格 ”)， 将 所 有 制 表 符 都 转换 为 空格 。 

2. 设置 行 长 标志 

在 大 多 数 编辑 器 中 ， 都 可 设置 视觉 线索 (通常 是 一 条 竖 线 )， 来 指出 代码 行 应 在 什么 地 方 结 
束 。 要 在 Geany 中 设置 这 项 功能 ， 请 选择 菜单 Edit > Preferences， 再 依次 单 击 Editor 和 Display， 确 
保 启用 了 长 行 标志 ， 再 确保 文本 框 “ 列 ”中 的 值 为 79。 

3. 缩 进 和 撤销 缩 进 代码 块 

要 缩 进 代码 块 ， 可 选择 它 ， 再 选择 菜单 Edit 》 Format 》 Increase Indent， 也 可 按 Ctrl + I。 要 撤 
销 代 码 块 缩 进 ， 可 选择 菜单 Edit ”Format ”Decrease Indent， 也 可 按 Ctrl+U。 

4. 将 代码 块 注释 掉 

要 暂时 禁用 一 个 代码 块 ， 可 选择 它 ， 并 将 它 注释 掉 ， 这 样 Python 将 忽略 它 。 为 此 ， 可 选择 菜 
单 Edit 》 Format 》 Toggle Line Commentation， 也 可 按 Ctrl+ 卫 。 选 择 的 代码 将 被 注释 掉 ， 并 使 用 特 
殊 字 符 序 列 护 指出 这 不 是 常规 注释 。 要 对 代码 块 取消 注释 ， 可 选择 它 ， 并 再 次 选择 前 述 菜单 。 


B.2 Sublime Text 


Sublime Text 是 一 款 简单 的 文本 编辑 器 ， 它 在 OS X( 及 其 他 系统 ) 中 易于 安装 ， 让 你 能 够 直 
接 运 行 几乎 所 有 程序 。 它 还 能 在 内 山 在 Sublime Text 窗 口内 的 终端 会 话 中 运行 代码 ， 让 你 能 够 轻 
松 地 查看 输出 。 

Sublime Text 的 许可 策略 非常 灵活 ， 你 可 以 永久 地 免费 使 用 这 款 编辑 器 ， 但 如 果 你 喜欢 它 并 
想 长 期 使 用 ， 作 者 建议 你 购买 许可 证 。 我 们 将 下 载 Sublime Text 3 编写 本 书 时 的 最 新 版 本 。 
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B.2.1 在 OSX 系统 中 安装 Sublime Text 


要 下 载 Sublime Text 安 装 程 序 ， 可 访问 http://sublimetext.com/3， 单 击 链接 Download， 并 查找 
OS X 安 装 程序 。 下 载 安装 程序 后 ， 打 开 它 ， 再 将 Sublime Text 图 标 拖 放 到 文件 夹 Applications。 


B.2.2 在 Linux 系统 中 安装 Sublime Text 


在 大 多 数 Linux 系 统 中 ， 安 装 Sublime Text 的 最 简单 方式 是 通过 终端 会 话 ， 如 下 所 示 : 


$ sudo add-apt-repository ppa:webupd8team/sublime-text-3 
$ sudo apt-get update 
$ sudo apt-get install sublime-text-installer 


B.2.3 在 Windows 系统 中 安装 Sublime Text 


从 http://www.sublimetext.com/3 下 载 Windows 安 装 程序 。 运 行 这 个 安装 程序 , 你 将 在 开始 菜 
中 看 到 Sublime Text。 


B.2.4 在 Sublime Text 中 运行 Python 程序 


如 果 你 使 用 的 是 系统 自 带 的 Python 版 本 , 可 能 无 需 调整 任何 设置 就 能 运行 程序 。 要 运行 程序 ， 
可 选择 菜单 Tools > Build 或 按 Ctrl+B。 运行 hello world.py 时 , 你 将 在 Sublime Text 窗 口 的 底部 看 到 
一 个 终端 屏幕 ， 其 中 包含 如 下 输出 : 


Hello Python world! 
[Finished in 0.1s] 


B.2.5 配置 Sublime Text 


如 果 你 安装 了 多 个 Python 版 本 或 者 Sublime Text 不 能 自动 运行 程序 ,你 可 能 需要 设置 一 个 配置 
文件 。 你 首先 需要 知道 Python 解释 器 的 完整 路 径 ， 为 此 ， 在 Linux 或 OS X 系 统 中 执行 如 下 命令 : 


$ type -a python3 

python3 is /usr/local/bin/python3 

请 将 python3 替 换 为 你 启动 终端 会 话 时 使 用 的 命令 。 

如 果 你 使 用 的 是 Windows 系 统 ， 要 获悉 Python 解释 器 的 路 径 ， 请 参阅 “在 Windows 系 统 中 安 
装 Python 3” 一 节 。 

现在 ， 启 动 Sublime Text， 并 选择 菜单 Tools > Build System 》 New Build System， 这 将 打开 一 
个 新 的 配置 文件 。 删 除 其 中 的 所 有 内 容 ， 再 输入 如 下 内 容 : 
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Python3 .sublime-build 
{ 
} 


这 些 代 码 让 Sublime Text 使 用 命令 python3 来 运行 当前 打开 的 文件 。 请 确保 其 中 的 路 径 为 你 在 前 
一 步 获悉 的 路 径 〈 在 Windows 系 统 中 ， 该 路 径 类 似 于 C:/Python35/python )。 将 这 个 配置 文件 命名 
为 Python3.sublime-build， 并 将 其 保存 到 默认 目录 选择 菜单 Save 时 Sublime Text 打 开 的 目录 。 

打开 hello world.py， 选 择 菜 单 Tools > Build System ”Python3 ， 再 选择 菜单 Tools Build， 你 
将 在 内 构 在 Sublime Text 窗 口 底部 的 终端 中 看 到 输出 。 


"cmd": ["/usr/local/bin/python3", "-u", "$file"], 


B.2.6 ”定制 Sublime Text 的 设置 


下 面 来 定制 本 附录 开头 提 到 的 功能 ， 以 尽 可 能 提高 Sublime Text 的 效率 。 

1. 将 制 表 符 转换 为 空 

选择 菜单 View * Indentation , 核实 选择 了 复 选 框 Indent Using Spaces。 如 果 没 有 选择 该 复 选 框 ， 
现在 选择 它 。 

2. 设置 行 长 标志 

选择 菜单 View 》 Ruler， 再 单 击 80，Sublime Text 将 在 这 个 80 字 符 标志 处 放置 一 条 竖 线 。 

3. 缩 进 和 取消 缩 进 代码 块 

要 缩 进 代码 块 ， 可 选择 它 ， 再 选择 菜单 Edit 》 Line ”Indent 或 按 Ctrl + ]。 要 取消 缩 进 代码 块 ， 
可 选择 菜单 Edit >》 Line 》 Unindent 或 按 Ctrl + [。 

4. 将 代码 块 注释 掉 

要 将 代码 块 注 释 掉 ， 可 选择 它 ， 再 选择 菜单 Edit > Comment 》Toggle Comment 或 按 Ctrl + /。 
要 取消 代码 块 注释 ， 再 次 执行 这 个 命令 。 


B.3 IDLE 


IDLE 是 Python 的 默认 编辑 器 ， 相 比 于 Geany 和 Sublime Text， 它 不 那么 直观 , 但 其 他 教程 指出 
它 适 合 初学 者 使 用 ， 因 此 你 不 妨 试 一 试 。 
3 


B.3.1 在 Linux 系统 中 安装 IDLE 


如 果 你 使 用 的 是 Python 3， 请 像 下 面 这 样 安装 idle3 包 : 


$ sudo apt-get install idle3 


如 果 你 使 用 的 是 Python 2， 请 像 下 面 这 样 安装 idle 包 : 


$ sudo apt-get install idle 
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B.3.2 在 OSX 系统 中 安装 IDLE 


如 果 你 的 Python 是 使 用 Homebrew 安 装 的 ， 那 么 可 能 已 经 安装 了 IDLE。 在 终端 中 ， 执 行 命令 
brew linkapps， 它 告诉 IDLE 如 何在 系统 中 查找 正确 的 Python 解释 需 。 随 后 ， 你 会 在 文件 夹 
Applications 中 看 到 IDLE。 

如 果 你 的 Python 不 是 使 用 Homebrew 安 装 的 ， 请 访问 https:/www.python.org/download/mac/ 
tcltk/， 并 按 这 里 的 说 明 做 。 你 还 需 安装 IDLE 依 赖 的 一 些 图 形 包 。 


B.3.3 在 Windows 系统 中 安装 IDLE 


你 安装 Python 时 ， 应 该 自动 安装 了 IDLE， 因 此 它 应 该 包含 在 开始 菜单 中 。 


B.3.4 定制 IDLE 的 设置 


由 于 IDLE 是 默认 的 Python 编辑 器 ,因此 它 的 大 多 数 设 置 都 被 设置 为 推荐 的 Python 设置 : 将 制 
表 符 自动 转换 为 空格 ; 行 长 标志 出 现在 80 字 符 处 。 

1. 缩 进 和 取消 缩 进 代码 块 

要 缩 进 代 码 块 ， 可 选择 它 ， 再 选择 菜单 Format ”Indent Region 或 按 Ctrl + ]; 要 取消 代码 块 缩 
进 ， 可 选择 菜单 Format 》 Dedent Region 或 按 Ctrl + [。 

2. 将 代码 块 注释 掉 

要 将 代码 块 注释 掉 ， 可 选择 它 ， 再 选择 菜单 Format 》 Comment Out Region 或 按 Alt + 3。 要 取 
消 代 码 块 注释 ， 可 选择 菜单 Format 》 Uncomment Region 或 按 Alt + 4。 


B.4 Emacs 和 vim 


Emacs 和 vim 是 两 款 流行 的 编辑 器 ， 深 受众 多 经 验 丰富 的 程序 员 的 喜爱 ， 因 为 使 用 它们 时 ， 
用 户 根本 不 用 离开 键盘 。 因 此 ， 学 会 使 用 这 些 编辑 器 后 ， 编 写 、 阅 读 和 编辑 代码 的 效率 将 极 高 ; 
这 也 意味 着 学 习 使 用 它们 的 难度 极 大 。 

程序 员 通 常会 推荐 你 试 一 试 ， 但 很 多 熟练 的 程序 员 忘 了 编程 新 手 尝 试 学 习 使 用 它们 将 花费 
很 多 时 间 。 知 道 这 些 编辑 器 是 有 益 的 ， 但 请 先 使 用 简单 的 编辑 器， 它们 让 你 能 够 专注 于 学 习 编 
程 ， 而 不 是 费时 间 去 学 习 如 何 使 用 编辑 器 。 等 你 能 够 熟悉 地 编写 和 编辑 代码 后 ， 再 去 使 用 这 些 
编辑 噩 吧 。 


寻求 帮助 


每 个 人 学 习 编 程 时 都 会 遇 到 困难 , 因此 作为 程序 员 , 需要 学 习 的 
最 重要 的 技能 之 一 是 如 何 高 效 地 摆脱 困境 。 这 个 附录 简要 地 介绍 几 种 
方法 ， 以 帮助 你 摆脱 编程 困境 。 


C.1 第 一 步 
陷入 困境 后 ， 首 先 需要 判断 形势 。 你 必须 能 够 明确 地 回答 如 下 三 个 问题 ， 才 能 够 从 他 人 那里 
获得 帮助 。 


口 你 想 要 做 什么 ? 
口 你 已 尝试 哪些 方式 ? 
D 结果 如 何 ? 

答案 应 尽 可 能 具体 。 对 于 第 一 个 问题 ， 像 “我 要 在 我 的 Windows 10 计 算 机 上 安装 最 新 版 本 的 
Python 3” 这 样 明 确 的 陈述 足够 详细 ， 证 Python 社区 的 其 他 人 员 能 够 施 以 援手 ; 而 像 “ 我 要 安装 
Python” 这 样 的 陈述 没有 提供 足够 的 信息 ， 别 人 无 法 提供 太 多 的 帮助 。 

对 于 第 二 个 问题 , 你 的 答案 应 提供 足够 多 的 细节 , 这 样 别 人 就 不 会 建议 你 去 重复 已 经 尝试 过 的 
方式 : 相 比 于 “我 访问 Python 网 站 ， 并 下 载 了 一 个 安装 程序 ” “我 访问 http://python.org/downloads/， 
并 单 击 Python 3 的 Download 按 钮 ， 再 运行 这 个 安装 程序 ”提供 的 信息 更 详细 。 

对 于 最 后 一 个 问题 ， 知 道 准确 的 错误 消息 对 在 线 搜索 解决 方案 或 寻求 帮助 很 有 用 。 

有 了 时候, 通过 回答 这 三 个 问题 ， 你 会 发 现 遗 漏 了 什么 ， 从 而 无 需 再 做 其 他 的 事情 就 能 摆脱 困 
境 。 程 序 员 甚至 给 这 种 情形 提供 了 一 个 名 称 , 称 之 为 橡皮 鸭子 调试 法 。 如 果 你 向 一 只 橡皮 鸭子 (或 
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任何 无 生命 的 东西 ) 清 楚 地 阐述 自己 的 处 境 , 并 向 它 提 出 具体 的 问题 , 你 常常 能 够 回答 这 个 问题 。 
有 些 编程 公司 甚至 在 办 公 室 放置 一 个 橡皮 胸 子 ， 旨 在 鼓励 程序 员 “ 与 这 只 鸭子 交流 ”。 


C.1.1 再 试 试 

只 需 回 过 头 去 重新 来 一 次 ， 就 足以 解决 很 多 问题 。 假 设 你 正 模仿 本 书 的 示例 编写 一 个 for 循 
环 ， 你 可 能 遗漏 了 某 种 简单 的 东西 ， 如 for 语 名 未 尾 的 胃 号 。 再 试 一 次 可 能 就 会 帮助 你 避免 重复 
同样 的 错误 。 


C.1.2 ” 歇 一 会 儿 


如 果 你 很 长 时 间 内 一 直 在 试图 解决 同一 个 问题 , 那么 休息 一 会 儿 实际 上 是 你 可 采取 的 最 佳 战 
术 。 长 时 间 从 事 一 个 任务 时 ， 你 可 能 变 得 一 根 筋 ， 脑 子 里 想 的 都 是 一 个 解决 方案 。 你 对 所 做 的 假 
设 往往 会 视而不见 ， 而 休息 一 会 儿 有 助 于 你 从 不 同 的 角度 看 问题 。 不 用 休息 很 长 时 间 ， 只 需 让 你 
能 够 摆脱 当前 的 思维 方式 就 行 。 如 果 你 坐 了 很 长 时 间 , 起 来 做 做 运动 。 溜 达 溜 达 或 去 外 面 待 一 会 
儿 ， 也 可 以 喝 杯 水 ， 或 者 吃 点 清淡 而 健康 的 零食 。 

如 果 你 心情 诅 形 ,也 许 该 将 工作 放 到 一 边 ， 整 天 都 不 考虑 了 。 晚 上 睡 个 好 觉 后 ， 你 带 常 会 发 
现 问题 并 不 是 那么 难 解决 。 


C.1.3 参考 本 书 的 在 线 资源 


本 书 通过 https://www.nostarch.com/pythoncrashcourse/ 提 供 了 配套 的 在 线 资源 ， 其 中 包含 大 量 
有 用 的 信息 , 比如 如 何 设置 系统 以 及 如 何 解 决 每 章 可 能 遇 到 的 难题 ,如果 你 还 没有 查看 这 些 资源 ， 
现在 就 去 查看 吧 ， 看 看 它们 能 否 提 供 帮 助 。 


C.2 在线 搜索 


很 可 能 有 人 以 前 遇 到 过 你 面临 的 问题 , 并 在 网 上 发 表 了 相关 的 文章 。 良 好 的 搜索 技能 和 具体 
的 关键 字 有 助 于 你 找到 现 有 的 资源 ， 供 你 用 来 解决 当前 面临 的 问题 。 例 如 ， 如 果 你 无 法 在 使 用 
Windows 10 的 计算 机 上 安装 Python 3， 那 么 搜索 “python 3 windows 10” 可 能 会 让 你 马上 找到 解 
决 问题 的 方案 。 

搜索 计算 机 显示 的 错误 消息 也 极 有 帮助 。 例 如 ,假设 你 试图 启动 Python 终 端 会 话 时 出 现 了 如 
下 错误 消息 : 


> python 
"python” is not recognized as an internal or external command 
> 


通过 搜索 完整 的 错误 消息 “python is not recognized as an internal or external command ”， 也 许 
能 得 到 不 错 的 建议 。 
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当 你 搜索 与 编程 相关 的 主题 时 ， 有 几 个 网 站 会 反复 出 现 。 下 面 简要 地 介绍 一 下 这 些 网 站 , 让 
你 知道 它们 可 能 提供 什么 样 的 帮助 。 


C.2.1 Stack Overflow 


Stack Overflow ( http://stackoverflow.com/ ) 是 最 受 程序 员 欢 迎 的 问答 网 站 之 一 ， 当 你 执行 与 
Python 相 关 的 搜索 时 ， 它 常常 会 出 现在 第 一 个 结果 页 中 。 其 成 员 在 陷入 困境 时 提出 问题 ， 其 他 
成 员 努 力 提 供 有 帮助 的 答案 。 用 户 可 推荐 他 认为 最 有 帮助 的 答案 ， 因 此 前 几 个 答案 通常 就 是 最 
佳 答案 。 

对 于 很 多 基本 的 Python 问题 , Stack Overflow 都 有 非常 明确 的 答案 , 因为 这 个 社区 在 不 断 改 进 。 
它 鼓 励 用 户 发 布 更 新 的 帖子 ， 因 此 这 里 的 答案 通常 与 时 俱 进 。 编 写本 书 时 ，Stack Overflow 回 答 
的 与 Python 相关 的 问题 超过 了 400 000 个 。 


C.2.2 ”Python 官方 文档 


对 初学 者 来 说 ，Python 官 方 文 档 ( http://docs.python.org/ ) 显得 有 点 漫不经心 ， 因 为 其 主要 目 
的 是 阐述 这 门 语言 ， 而 不 是 进行 解释 。 官 方 文档 中 的 示例 应 该 很 有 用 ， 但 你 也 许 不 能 完全 弄 懂 。 
虽然 如 此 ， 这 还 是 一 个 不 错 的 资源 ， 如 果 它 出 现在 搜索 结果 中 ， 就 值得 你 去 参考 ; 另外 ， 随 着 你 
对 Python 的 认识 越 来 越 深 入 ， 这 个 资源 的 用 处 将 越 来 越 大 。 


C.2.3 ”官方 库 文档 


如 果 你 使 用 了 库 ， 如 Pygame 、matplotlib、Django 等 ， 搜 索 结 果 中 通常 会 包含 到 其 官方 文档 
的 链接 ， 例 如 ，http:/docs.djangoproject.com/ 就 很 有 用 。 如 果 你 要 使 用 这 些 库 ， 最 好 熟悉 其 官方 
文档 。 


C.2.4 tr/learnpython 

Reddit 包 含 很 多 子 论 坛 ， 这 些 子 论坛 被 称 为 subreddit， 其 中 的 r/learnpython ( http://reddit.com/ 
r/learnpython/ ) 非常 活跃 ， 提 供 的 信息 也 很 有 帮助 。 你 可 以 在 这 里 阅读 其 他 人 提出 的 问题 ， 也 可 
提出 自己 的 问题 。 


C.2.5 博客 


很 多 程序 员 都 有 博客 , 旨 在 与 人 分 享 针对 其 使 用 的 语言 部 分 撰写 的 帖子 。 接 受 博客 文章 提供 
的 建议 前 ， 你 应 大 致 浏览 一 下 前 几 个 评论 ,看 看 其 他 人 的 反应 。 如 果 文 章 没 有 任何 评论 ,请 对 其 
持 保留 态度 一 一 它 提供 的 建议 可 能 还 没有 人 验证 过 。 


C.3 IRC 


程序 员 通过 IRC ( Internet Relay Chat ) 实时 地 交流 。 如 果 你 被 问题 困 住 ， 那 么 在 网 上 搜索 也 
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找 不 到 答案 ,那么 在 相关 的 IRC 频 道 (channel ) 中 寻求 帮助 可 能 是 最 佳 选 择 。 出 没 在 这 些 频 道中 
的 人 大 多 彬 彬 有 礼 、 乐 于 助人 , 在 你 能 够 详细 地 描述 你 想 做 什么 、 尝 试 了 哪些 方法 以 及 这 些 方法 
的 结果 时 尤其 如 此 。 


C.3.1 创建 IRC 账户 


要 建立 IRC 账 户 ， 请 访问 http:/webchat.freenode.ne， 选 择 一 个 昵称 ， 输 入 验证 码 ， 再 单 击 


Connect。 你 将 看 到 一 条 消息 ， 欢 迎 你 访问 freenode IRC 服 务 器 。 在 窗口 底部 的 方 框 中 ， 输 入 如 下 


/msg nickserv register password email 


请 将 其 中 的 password 和 emai27 蔡 换 为 你 的 密码 和 电子 邮件 地 址 。 请 选择 一 个 不 用 于 其 他 账户 
的 简单 密码 ， 这 个 密码 不 会 以 安全 的 方式 传输 ， 因 此 根本 不 要 试图 去 创建 安全 的 密码 。 你 将 收 到 
封 邮 件 ， 其 中 包含 有 关 如 何 验 证 账户 的 说 明 。 这 封 邮 件 将 向 你 提供 一 个 类 似 于 下 面 的 命令 : 


/msg nickserv verify register nickname verification code 


将 这 一 行 粘贴 到 蕊 C 网 站 ,将 其 中 的 nickname 替 换 为 你 在 前 面 选 择 的 上 昵称， 并 将 
Verification_code 蔡 换 为 你 看 到 的 验证 码 。 现 在 ， 你 就 可 以 加 入 频道 了 。 


C.3.2 ”加 入 频道 


要 加 入 Python 主 频道 ， 可 在 输入 框 中 输入 /join #python， 你 将 看 到 一 条 确认 消息 ， 指 出 你 加 
人 了 该 频道 ， 还 将 看 到 有 关 该 频道 的 简介 。 

频道 撩 learnpython【 两 个 井 号 ) 也 非常 活跃 。 这 个 频道 与 http:/reddit,com/wlearnpython/ 相 关 
联 ， 因 此 你 在 其 中 也 将 看 到 有 关 r/learnpython 上 发 表 的 帖子 的 消息 。 频 道 #pyladies 专 注 于 支持 学 
习 Python 的 女性 和 女性 程序 员 拥 和 是。 如 果 你 正在 开发 Web 应 用 程序 ， 可 能 想 加 入 频道 #django。 

加 入 频道 后 ， 就 可 看 到 其 他 人 的 交流 ， 还 可 提出 问题 。 


C.3.3 IRC 文 化 


要 获得 有 效 的 帮助 ， 你 需要 知道 一 些 有 关 IRC 文 化 的 细节 。 将 重点 放 在 这 个 附录 开头 所 说 的 
三 个 问题 , 无疑 有 助 于 获得 可 行 的 解决 方案 。 如 果 你 能 准确 地 阐述 你 要 做 什么 、 尝 试 了 哪些 方法 
以 及 得 到 的 结果 ， 别 人 就 会 乐意 伸 出 援手 。 为 分 享 代码 或 输出 ，IRC 成 员 使 用 专门 为 此 创建 的 外 
部 网 站 ， 如 https://bpaste.net/+python/( #python 通 过 它 来 分 享 代 码 和 输出 )。 这 避免 了 频道 充斥 着 
代码 ， 还 让 分 享 的 代码 阅读 起 来 容易 得 多 。 

一 定 要 有 耐心 ,， 这样 别人 才 会 更 乐意 帮助 你 。 准 确 地 提出 问题 ， 并 等 待 别人 来 回答 。 虽 然 大 
家 都 在 忙于 交流 ,但 通常 总 会 有 人 及 时 地 回答 你 的 问题 。 如 果 频 道 的 参与 者 较 少 , 可 能 需要 等 一 
段 时 间 才 会 有 人 回答 你 的 问题 。 


使 用 Git 进 行 版 杰 控 制 


版 本 控制 软件 让 你 能 够 拍摄 处 于 可 行 状态 的 项 目的 快照 ,修改 项 
目 (如 实现 新 功能 ) 后 ， 如 果 项 目 不 能 正常 运行 , 可 恢复 到 前 一 个 可 
行 状态 。 

通过 使 用 版 本 控制 软件 ， 你 可 以 无 已 无 虑 地 改进 项 目 ， 不 用 担心 
项 目 因 你 犯 了 错 而 遭 到 破坏 。 对 大 型 项 目 来 说 ， 这 显得 尤其 重要 ,但 
对 于 较 小 的 项 目 ， 哪 怕 是 只 包含 一 个 文件 的 程序 ， 这 也 大 有 神 益 。 

在 这 个 附录 中 ， 你 将 学 习 如 何 安装 Git， 以 及 如 何 使 用 它 来 对 当 
前 开发 的 程序 进行 版 本 控制 。Git 是 当前 最 流行 的 版 本 控制 软件 ， 它 
包含 很 多 高 级 工具 ,可 帮助 团队 协作 开发 大 型 项 目 , 但 其 最 基本 的 功 
能 也 非常 适合 独立 开发 人 员 使 用 。Git 通 过 跟踪 对 项 目 中 每 个 文件 的 修改 来 实现 版 本 控制 ， 
如 果 你 犯 了 错 ， 只 需 恢复 到 保存 的 前 一 个 状态 即 可 。 


D.1 安装 Git 


Git 可 在 所 有 操作 系统 上 运行 ， 但 其 安装 方法 因 操 作 系 统 而 异 。 接 下 来 的 几 节 详细 说 明了 如 
何在 各 种 操作 系统 中 安装 它 。 


D.1.1 在 Linux 系统 中 安装 Git 


要 在 Linux 系 统 中 安装 Git， 请 执行 如 下 命令 : 


$ sudo apt-get install git 


这 就 成 了 。 你 现在 可 以 在 项 目 中 使 用 Git 了 。 
D.1.2 在 OSX 系统 中 安装 Git 


尔 的 OS XX 系统 可 能 已 经 安装 了 Git， 因 此 请 尝试 执行 命令 git --version。 如 果 你 在 输出 中 看 
到 了 具体 的 版 本 号 ， 说 明 你 的 系统 安装 了 Git; 如 果 你 看 到 一 条 消息 ， 提 示 你 安装 或 升级 Git， 只 
需 按 屏幕 上 的 说 明 做 即 可 。 
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你 也 可 以 访问 https://git-scem.com/, 单 击 链接 Downloads ,再 单 击 适 合 你 所 用 系统 的 安装 程序 。 


D.1.3 在 Windows 系统 中 安装 Git 
要 在 Windows 系 统 中 安装 Git， 请 访问 http://msysgit.github.io/， 并 单 击 Download。 
D.1.4 配置 Git 


Git 跟 踪 谁 修改 了 项 目 ， 哪 怕 参 与 项 目 开 发 的 人 只 有 一 个 。 为 此 ，Git 需 要 知道 你 的 用 户 名 和 
电子 邮件 地 址 。 你 必须 提供 用 户 名 ,但 可 以 使 用 虚构 的 电子 邮件 地 址 : 


$ git config --global user.name "wsername" 
$ git config --global user.email "wsername@example.com 


如 果 你 忘记 了 这 一 步 ， 在 你 首次 提交 时 ，Git 将 提示 你 提供 这 些 信 息 。 


D.2 创建 项 目 


我 们 来 创建 一 个 要 进行 版 本 控制 的 项 目 。 在 你 的 系统 中 创建 一 个 文件 来， 并 将 其 命名 为 
git_practice。 在 这 个 文件 夹 中 ， 创 建 一 个 简单 的 Python 程序 : 


hello_world.py 


print("Hello Git world!") 
我 们 将 使 用 这 个 程序 来 探索 Git 的 基本 功能 。 
D.3 忽略 文件 


扩展 名 为 .pyc 的 文件 是 根据 .py 文件 自动 生成 的 ， 因 此 我 们 无 需 让 Git 跟 踪 它 们 。 这 些 文件 存 
储 在 目录 _pycache 中。 为 让 Git 忽 略 这 个 目录 ， 创 建 一 个 名 为 .gitignore 的 特殊 文件 ( 这 个 文件 
名 以 句点 打头 ， 且 没有 扩展 名 )， 并 在 其 中 添加 下 面 一 行内 容 : 


.gitignore 


_ pycache / 


这 让 Git 忽 略 目录 pycache ”中 的 所 有 文件 。 使 用 文件 .gitignore 可 和 避免 项 目 混乱 ， 开 发 起 来 
更 容易 。 


注意 如 果 你 使 用 的 是 Python 2.7， 请 将 这 行内 容 改 为 *.pyc 。Python 2.7 不 会 创建 目录 
_ pycache ”， 它 将 每 个 .pyc 文 件 都 存储 在 相应 .py 文件 所 在 的 目录 中 。 其 中 的 星 号 让 Git 
忽略 所 有 扩展 名 为 .pyc 的 文件 。 
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你 可 能 需要 修改 文本 编辑 器 的 设置 ， 使 其 显示 隐藏 的 文件 ， 这 样 才能 使 用 它 来 打开 文 
件 .gitignore。 有 些 编辑 右 被 设置 成 忽略 名 称 以 句点 打头 的 文件 。 


D.4 初始 化 仓库 


你 创建 了 一 个 目录 , 其 中 包含 一 个 Python 文件 和 一 个 .gitignore 文 件 , 可 以 初始 化 一 个 Git 仓 库 
了 。 为 此 ， 打 开 一 个 终端 窗口 ， 切 换 到 文件 夹 git_ practice， 并 执行 如 下 命令 : 


git practice$ git init 
Initialized empty Git repository in git practice/.git/ 
git practice$ 


偷 出 表明 Git 在 git_practice 中 初始 化 了 一 个 空仓 库 。 仓 库 是 程序 中 被 Git 主 动 跟踪 的 一 组 文件 。 
Git 用 来 管理 仓库 的 文件 都 存储 在 隐藏 的 .git 中 ， 你 根本 不 需要 与 这 个 目录 打交道 ,但 千 万 不 要 删 
除 这 个 目录 ， 和 否则 将 丢弃 项 目的 所 有 历史 记录 。 

D.5 检查 状态 


执行 其 他 操作 前 ， 先 来 看 一 下 项 目的 状态 : 


git practice$ git status 
@ # On branch master 
# 
# Initial commit 
# 
@ # Untracked files: 
# (use "git add <file>..." to include in what will be committed) 


# 
# .gitignore 
# hello world.py 
# 
@ nothing added to commit but untracked files present (use "git add" to track) 
git practice$ 


在 Git 中 ,分 支 是 项 目的 一 个 版 本 。 从 这 里 的 输出 可 知 ， 我 们 位 于 分 支 master 上 ( 见 @ )。 你 
每 次 查看 项 目的 状态 时 ， 输 出 都 将 指出 你 位 于 分 支 master 上 。 接 下 来 的 输出 表明 ， 我 们 将 进行 初 
始 提交 。 提 交 是 项 目 在 特定 时 间 点 的 快照 。 

Git 指 出 了 项 目 中 未 被 跟踪 的 文件 ( 见 @ )， 因 为 我 们 还 没有 告诉 它 要 跟踪 哪些 文件 。 接 下 来 ， 
我 们 被 告知 没有 将 任何 东西 添加 到 当前 提交 中 ， 但 我 们 可 能 需要 将 未 跟踪 的 文件 加 入 到 仓库 中 
( 见 @ )。 
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D.6 将 文件 加 入 到 仓库 中 
下 面 将 这 两 个 文件 加 入 到 仓库 中 ， 并 再 次 检查 状态 : 


@ git practice$ git add . 
@ git practice$ git status 
# On branch master 


# 
# Initial commit 
# 
# Changes to be committed: 
# (use "git rm --cached <file>..." to unstage) 
# 
@# new file: .gitignore 
# new file: hello world.py 
# 


git practice$ 


命令 git add .将 项 目 中 未 被 跟踪 的 所 有 文件 都 加 入 到 仓库 中 ( 见 @ )。 它 不 提交 这 些 文件 ， 
而 只 是 让 Git 开 始 关注 它们 。 现在 我 们 检查 项 目的 状态 时 , 发 现 Git 找 出 了 需要 提交 的 一 些 修改 ( 见 
@ )。 标签 new file 意 味 着 这 些 文件 是 新 添加 到 仓库 中 的 ( 见 @ )。 


D.7 执行 提交 
下 面 来 执行 第 一 次 提交 


@ git practice$ git commit -m "Started project." 
@ [master (root-commit) co3d2a3] Started project. 
@ 2 files changed, 1 insertion(+) 

create mode 100644 .gitignore 

create mode 100644 hello world.py 
@ git practice$ git status 

# On branch master 

nothing to commit, working directory clean 

git practice$ 


我 们 执行 命令 git commit -m "message"( 见 @ ) 以 拍摄 项 目的 快照 。 标 志 -miEGit 将 接 下 来 的 
消息 ("Started project." ) 记录 到 项 目的 历史 记录 中 。 输 出 表明 我 们 在 分 文 master 上 ( 见 @ )， 
且 有 两 个 文件 被 修改 了 ( 见 @ )。 

现在 我 们 检查 状态 时 ， 发 现 我 们 在 分 支 master 上 ， ( 见 @ )。 这 是 你 每 次 
提交 项 目的 可 行 状态 时 都 希望 看 到 的 消息 。 如 果 显 示 的 消息 不 是 这 样 的 ,请 仔细 阅读 ， 很 可 能 你 
在 提交 前 忘记 了 添加 文件 。 
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D.8 查看 提交 历史 
Git 记 录 所 有 的 项 目 提交 。 下 面 来 看 一 下 提交 历史 


git practice$ git log 

commit a9d74d87f1aa3b8f5b2688cb586eac1a908cfc7f 
Author: Eric Matthes <eric@example.com> 

Date: Mon Mar 16 07:23:32 2015 -0800 


Started project. 
git practice$ 


你 每 次 提交 时 ，Git 都 会 生成 一 个 包含 40 字 符 的 独一无二 的 引用 ID。 它 记录 提交 是 谁 执 行 的 、 
提交 的 时 间 以 及 提交 时 指定 的 消息 。 并 非 在 任何 情况 下 你 都 需要 所 有 这 些 信 息 ， 因 此 Git 提 供 了 
一 个 选项 ， 让 你 能 够 打印 提交 历史 条 目的 更 简单 的 版 本 : 


git practice$ git log --pretty=oneline 
a9d74d87f1aa3b8f5b2688cb586eac1a908cfc7f Started project. 
git practice$ 


标志 --pretty=oneline 指 定 显示 两 项 最 重要 的 信息 : 提交 的 引用 ID 以 及 为 提交 记录 的 消息 。 
D.9 第 二 次 提交 


为 展示 版 本 控制 的 强大 威力 ,我 们 需要 对 项 目 进 行 修改 ,并 提交 所 做 的 修改 。 为 此 , 我 们 在 
hello_ world.py 中 再 添加 一 行 代 码 : 


hello_world.py 


print("Hello Git world!") 
print("Hello everyone.") 


如 


我 们 现在 查看 项 目的 状态 ， 将 发 现 Git 注 意 到 了 这 个 文件 发 生 了 变化 : 


局 


git practice$ git status 
@ # On branch master 
# Changes not staged for commit: 
# (use "git add <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


# 
# 

@# modified: hello world.py 
# 


@ no changes added to commit (use "git add" and/or "git commit -a") 
git practice$ 


输出 指出 了 我 们 当前 所 在 的 分 支 ( 见 @ )、 被 修改 了 的 文件 的 名 称 ( 见 @ )， 还 指出 了 所 做 的 
修改 未 提交 ( 见 @ )。 下 面 来 提交 所 做 的 修改 ， 并 再 次 查看 状态 : 
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@ git _ practice$ git commit -am "Extended greeting." 
[master 08d4d5e] Extended greeting. 
file changed, 1 insertion(+) 
@ git practice$ git status 

# On branch master 
nothing to commit, working directory clean 
@ git practice$ git log --pretty=oneline 
08d4d5e39cb906f6cff197bd48e9ab32203d7ed6 Extended greeting. 
beo17b7f06d390261dbc64ff593be6803fd2e3a1 Started project. 
git practice$ 


我 们 再 次 执行 了 提交 ， 并 在 执行 命令 git commit 时 指定 了 标志 -am ( 见 @ )。 标志 -a 让 Git 将 仓 


库 中 所 有 修改 了 的 文件 都 加 入 到 当前 提交 中 ( 如 果 你 在 两 次 提交 之 间 创 建 了 新 文件 , 可 再 


命令 git add .将 这 些 新 文件 加 入 到 仓库 中 )。 标 志 -miEGit 在 提交 历史 中 记录 一 条 消息 。 


次 执行 


我 们 查看 项 目的 状态 时 ， 发 现 工作 目录 也 是 干净 的 〈 见 @ )。 最 后 ， 我 们 发 现 提交 历 史 中 包 


含 两 个 提交 ( 见 @ )。 


D.10 撤销 修改 


下 面 来 看 看 如 何 放弃 所 做 的 修改 , 恢复 到 前 一 个 可 行 状 态 。 为 此 , 首先 在 hello_world.py 中 再 


添加 一 行 代码 : 
hello_world.py 


print("Hello Git world!") 
print("Hello everyone.") 


print("Oh no, I broke the project!") 


保存 并 运行 这 个 文件 。 
我 们 查看 状态 ， 发 现 Git 注 意 到 了 所 做 的 修改 : 


git practice$ git status 

# On branch master 

# Changes not staged for commit: 

# (use "git add <file>..." to update what will be committed) 
# (use "git checkout -- <file>..." to discard changes in working directory) 
# 

# modified: hello world.py 

# 

no changes added to commit (use "git add" and/or "git commit -a") 

git practice$ 


Git 注 意 到 我 们 修改 了 hello_world.py( 见 @ )。 我们 可 以 提交 所 做 的 修改 ,但 这 次 我 们 不 提交 
所 做 的 修改 ， 而 要 恢复 到 最 后 一 个 提交 ( 我 们 知道 ， 那 次 提交 时 项 目 能 够 正常 地 运行 )。 为 此 ， 


我 们 不 对 hello_world.py 执 行 任何 操作 


不 删除 刚 添加 的 代码 行 ,也 不 使 用 文本 编辑 器 的 撤销 功 
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而 在 终端 会 话 中 执行 如 下 命令 : 


Fl 
CC 


git practice$ git checkout . 

git practice$ git status 

# On branch master 

nothing to commit, working directory clean 
git practice$ 


命令 git checkout 让 你 能 够 恢复 到 以 前 的 任何 提交 。 命 令 git checkout .放弃 自 最 后 一 次 提 
交 后 所 做 的 所 有 修改 ， 将 项 目 恢复 到 最 后 一 次 提交 的 状态 。 
如 果 我 们 返回 到 文本 编辑 器 ， 将 发 现 hello_world.py 被 修改 成 了 下 面 这 样 : 


print("Hello Git world!") 
print("Hello everyone.") 


就 这 个 项 目 而 言 , 恢复 到 前 一 个 状态 微不足道 , 但 如 果 我 们 开发 的 是 大 型 项 目 , 其 中 数 十 个 
文件 都 被 修改 了 ,那么 恢复 到 前 一 个 状态 , 将 撤销 自 最 后 一 次 提交 后 对 这 些 文件 所 做 的 所 有 修改 。 
这 个 功能 很 有 用 : 实现 新 功能 时 ,你 可 以 根据 需要 做 任意 数量 的 修改 ,如 果 这 些 修改 不 可 行 ， 可 
撤销 它们 , 而 不 会 对 项 目 有 任何 伤害 。 你 无 需 记 住 做 了 哪些 修改 , 因而 不 必 手 工 撤销 所 做 的 修改 ， 
Git 会 蔡 你 完成 所 有 这 些 工作 。 


注意 ” 想 要 看 到 以 前 的 版 本 ， 你 可 能 需要 在 编辑 器 窗口 中 单 击 ， 以 刷新 文件 。 


D.11 检 出 以 前 的 提交 


你 可 以 检 出 提交 历史 中 的 任何 提交 ， 而 不 仅仅 是 最 后 一 次 提交 ， 为 此 可 在 命令 git check 末 
尾 指定 该 提交 的 引用 ID 的 前 6 个 字符 ( 而 不 是 句点 ), 通过 检 出 以 前 的 提交 , 你 可 以 对 其 进行 审核 ， 
然后 返回 到 最 后 一 次 提交 ， 或 者 放弃 最 近 所 做 的 工作 ， 并 选择 以 前 的 提交 : 


git practice$ git log --pretty=oneline 
08d4d5e39cb906f6cff197bd48e9ab32203d7ed6 Extended greeting. 
beo17b7f06d390261dbc64ff593be6803fd2e3a1 Started project. 
git practice$ git checkout be017b 

Note: checking out 'be017b'. 


@ You are in 'detached HEAD' state. You can look around, make experimental 
changes and commit them, and you can discard any commits you make in this 
state without impacting any branches by performing another checkout. 


If you want to create a new branch to retain commits you create, you may 
do so (now or later) by using -b with the checkout command again. Example: 


git checkout -b new branch name 
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HEAD is now at be017b7... Started project. 
git practice$ 


检 出 以 前 的 提交 后 ， 你 将 离开 分 支 master， 并 进入 Git 所 说 的 分 离 头 指针 ( detached HEAD ) 
状态 ( 见 @ ), HEAD 表 示 项 目的 当前 状态 , 之 所 以 说 我 们 处 于 分 离 状态 , 是 因为 我 们 离开 了 一 个 
命名 分 支 ( 这 里 是 master )。 

要 回 到 分 支 master， 可 检 出 它 : 


git practice$ git checkout master 

Previous HEAD position was be017b7... Started project. 
Switched to branch 'master' 

git practice$ 


这 让 你 回 到 分 支 master。 除 非 你 要 使 用 Git 的 高 级 功能 , 否则 在 检 出 以 前 的 提交 后 , 最 好 不 要 
对 项 目 做 任何 修改 。 然 而 ， 如 果 参 与 项 目 开 发 的 人 只 有 你 自己 ， 而 你 又 想 放弃 较 近 的 所 有 提交 ， 
并 恢复 到 以 前 的 状态 , 也 可 以 将 项 目 重 置 到 以 前 的 提交 。 为 此 , 可 在 处 于 分 支 naster 上 的 情况 下 ， 
执行 如 下 命令 : 


© 


it practice$ git status 
On branch master 
thing to commit, working directory clean 
t practice$ git log --pretty=oneline 
8d4d5e39cb906f6cff197bd48e9ab32203d7ed6 Extended greeting. 
e017b7f06d390261dbc64ff593be6803fd2e3a1 Started project. 
t_ practice$ git reset --hard be017b 
EAD is now at be017b7 Started project. 

t practice$ git status 
On branch master 
nothing to commit, working directory clean 
© git practice$ git log --pretty=oneline 
beo17b7f06d390261dbc64ff593be6803fd2e3a1 Started project. 
git practice$ 


我 们 首先 查看 了 状态 ,确认 我 们 在 分 支 master 上 ( 见 @ )。 查看 提交 历史 时 , 我 们 看 到 了 两 个 
提交 ( 见 @ )。 接 下 来 ， 我 们 执行 命令 git reset --hard， 并 在 其 中 指定 了 要 永久 地 恢复 到 的 提交 
的 引用 ID 的 前 6 个 字符 ( 见 @ )。 再 次 查看 状态 ， 发 现 我 们 在 分 文 naster 上 ， 且 没有 需要 提交 的 修 
改 ( 见 @ )。 再 次 查看 提交 历史 时 ， 发 现 我 们 处 于 要 从 它 重新 开始 的 提交 中 ( 见 @ )。 


D.12 删除 仓库 


有 时 候 , 仓库 的 历史 记录 被 你 搞 乱 了 ， 而 你 又 不 知道 如 何 恢 复 。 在 这 种 情况 下 ， 你 首先 应 考 
虑 使 用 附录 C 介 绍 的 方法 寻求 帮助 。 如 果 无 法 恢复 且 参 与 项 目 开发 的 只 有 你 一 个 人 ， 可 继续 使 用 
这 些 文件 ， 但 要 将 项 目的 历史 记录 删除 一 一 删除 目录 .git。 这 不 会 影响 任何 文件 的 当前 状态 ， 而 
只 会 删除 所 有 的 提交 ， 因 此 你 将 无 法 检 出 项 目的 其 他 任何 状态 。 


二 


间 0q 工 09 OO0o 研 间 0Q 
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为 此 ， 可 打开 一 个 文件 浏览 器 ， 并 将 目录 .git 删 除 ， 也 可 通过 命令 行 完成 这 个 任务 。 这 样 做 
后 , 你 需要 重新 创建 一 个 仓库 ,以 重新 对 修改 进行 跟踪 。 下 面 演示 了 如 何在 终端 会 话 中 完成 这 个 
过 程 : 


© 


t practice$ git status 

On branch master 

ing to commit, working directory clean 

t practice$ rm -rf .git 

t practice$ git status 

1: Not a git repository (or any of the parent directories): .git 
t practice$ git init 

itialized empty Git repository in git practice/.git/ 

t practice$ git status 


On branch master 


口 
此 


oo 
QU 


f= 


©@ © ee 


Initial commit 


Untracked files: 
(use "git add <file>..." to include in what will be committed) 


.gitignore 
hello world.py 


nothing added to commit but untracked files present (use "git add" to track) 
@ git practice$ git add . 
git practice$ git commit -m "Starting over." 
[master (root-commit) 05f5e01] Starting over. 
2 files changed, 2 insertions(+) 
create mode 100644 .gitignore 
create mode 100644 hello world.py 
@ git practice$ git status 
# On branch master 
nothing to commit, working directory clean 
git practice$ 


我 们 首先 查看 了 状态 ， 发 现 工作 目录 是 干净 的 ( 见 @ )。 接 下 来 ,我们 使 用 命令 rm -rf .git 
( 在 Windows 系 统 中 ， 应 使 用 命令 rmdir /s .git ) 删除 了 目录 .git ( 见 @ )。 删 除 文件 夹 .git 后 ， 当 
我 们 再 次 查看 状态 时 ,被 告知 这 不 是 一 个 Git 仓 库 ( 见 @ )。Git 用 来 跟踪 仓库 的 信息 都 存储 在 文件 
夹 .git 中 ， 因 此 删除 该 文件 夹 也 将 删除 整个 仓库 。 

接 下 来 ,我们 使 用 命令 git init 新 建 一 个 全 新 的 仓库 ( 见 @ )。 然 后 ， 我 们 查看 状态 ， 发 现 
又 回 到 了 初始 状态 ， 等 待 着 第 一 次 提交 ( 见 @ )。 我 们 将 所 有 文件 都 加 入 仓库 ， 并 执行 第 一 次 提 
交 ( 见 @ )。 然 后 ,我 们 再 次 查看 状态 ， 发 现 我 们 在 分 支 naster 上 ， 且 没有 任何 未 提交 的 修改 ( 见 
@ )。 


需要 经 过 一 定 的 练习 才能 学 会 使 用 版 本 控制 ， 但 一 旦 开始 使 用 ， 你 就 再 也 离 不 开 它 。 


oh 
所 


0 


编程 技能 


祝贺 你 ! 你 已 学 习 了 Python 基 本 知识 , 并 利用 这 些 知识 创建 了 一 
些 有 意义 的 项 目 : 创建 了 一 款 游戏 , 对 一 些 数据 进行 了 可 视 化 ,还 创 
建 了 一 个 Web 应 用 程序 。 现在， 可 以 通过 众多 不 同 的 方式 进一步 提高 


首先 , 你 应 该 根据 自己 的 兴趣 继续 开发 有 意义 的 项 目 。 当 你 通过 编程 来 解决 重要 的 相关 问题 


时 ， 编 程 将 更 具 吸 引力 ， 而 现在 你 具备 了 开发 各 种 项 目 所 需 的 技 角 
可 以 开发 模仿 经 典 街机 游戏 的 游戏 。 你 可 能 想 研 究 一 些 对 你 来 说 很 


E。 你 可 以 开发 自己 的 游戏 ,也 
E 要 的 数据 ， 并 通过 可 视 化 将 


其 中 有 趣 的 规律 和 关系 展示 出 来 。 你 可 以 创建 自己 的 Web 应 月 


用 程序 。 


程序 ， 也 可 尝试 模拟 自己 喜欢 的 应 


只 要 有 机 会 就 向 别人 发 出 邀请 ,让 他 们 尝试 使 用 你 编写 的 程序 。 如 果 你 编写 了 游戏 , 邀请 别 
人 来 玩 一 玩 ; 如 果 你 创建 了 图 表 ， 向 别人 展示 展示 ， 看 看 他 们 能 否 看 明白 ; 如 果 你 创建 了 Web 应 


反馈 对 项 目 进行 改进 ， 这 样 你 就 能 成 为 更 优秀 的 程序 员 。 


用 程序 ,将 其 部 署 到 在 线 服务 器 ， 并 邀请 别人 尝试 使 用 它 。 听 听 用 户 怎么 说 ， 并 尝试 根据 他 们 的 


自己 劲 手 开发 项 目 时 , 肯定 会 遇 到 环 手 乃至 自己 无 法 解决 的 问题 。 想 办 法 寻求 帮助 , 在 Python 
社区 找到 适合 自己 的 位 置 。 加 入 当地 的 Python 用 户 组 , 或 者 到 一 些 在 线 Python 社 区 去 逛 竹 。 另 外 ， 


考虑 参加 附近 举办 的 Python 开发 者 大 会 (PyCon )。 


你 应 尽力 在 开发 自己 感 兴趣 的 项 目 和 提高 Python 技能 之 间 取 得 平衡 。 网 上 有 很 多 Python 学 习 
资料 ， 市 面 上 还 有 大 量 针 对 中 级 程序 员 编写 的 Python 图 书 。 现 在 你 掌握 了 基本 知识 ， 并 知道 了 如 
何 将 学 到 的 技能 付 诸 应 用 , 因此 这 些 资 料 中 很 多 都 是 你 能 看 懂 的 。 通过 阅读 教程 和 图 书 积累 更 多 


的 知识 ， 加 深 你 对 编程 和 Python 的 认识 。 深 入 学 习 Python 后 下 
解决 更 多 的 问题 。 


祝贺 你 在 学 习 Python 的 道路 上 走 了 这 人 么 远 ， 愿 你 在 以 后 的 学 习 中 有 好 运 相伴 


了 去 开发 项 目 时 


| ， 你 将 能 够 更 高 效 地 
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亚马逊 读者 评论 
“我 读 过 很 多 本 为 Python 初学 者 所 写 的 入 门 书 ， 到 目前 为 止 ， 这 是 我 最 爱 的 一 
本 。 这 本 Python 编程 书 内 容 全面 ， 讲 解 详细 ， 编 排 合理 ， 真 是 太 棒 了 1! ” 
“这 本 书 用 平实 的 语言 向 初学 者 解释 各 种 概念 ， 没 有 过 早 引 入 隐 了 星 难 懂 的 技术 术 
语 。 我 至 少 有 8 本 介绍 Python 的 书 ， 但 大 多 数 没 读 多 少 页 就 读 不 下 去 了 ; 而 阅读 这 本 
书 的 时 候 ， 我 能 更 轻松 地 理解 其 中 的 概念 并 且 一 直 坚 持 读 完 。” 


上 到 有 编程 基础 的 程序 员 ， 下 到 10 岁 少年 ， 想 入 门 Python 并 达到 可 以 开发 实际 项 目的 水 平 ， 本 书 是 
最 佳 选择 ! 

本 书 是 一 本 全 面 的 从 入 门 到 实践 的 Python 编程 教程 ， 带 领 读 者 快速 掌握 编程 基础 知识 ， 编 写 出 能 解决 
实际 问题 的 代码 并 开发 复杂 项 目 。 

书 中 内 容 分 为 基础 篇 和 实战 篇 两 部 分 。 基 础 篇 介绍 基本 的 编程 概念 ， 如 列表 、 字 典 、 类 和 循环 ， 并 指 
导读 者 编写 整洁 且 易 于 理解 的 代码 。 另 外 还 介绍 了 如 何 让 程序 能 够 与 用 户 交 互 ， 以 及 如 何在 代码 运行 前 进 
行 测试 。 实 战 篇 介绍 如 何 利用 新 学 到 的 知识 开发 功能 丰富 的 项 目 : 2D 游 戏 《 外 星人 入 侵 》， 数 据 可 视 化 实 


战 ，Web 应 用 程序 。 


灵 Pyth 阅读 路 线 {Python 数据 分 析 基 础 教程 : 
0 门 Numpy 学 习 指南 (第 2 版 ) ) 


| 《Python 语言 及 其 应 用 》 — 《Python 网 络 数据 采集 》 


《Python 基础 教程 ( 第 2 版 修订 版 ) 》 ”站 ;一 
[一 《Python 网 络 编程 攻略 》 ”| 《Python Web 开 发 : 测试 驱动 方法 》 
《 父 与 子 的 编程 之 旅 : 与 小 卡特 一 起 学 Python 》 
上 | 《精通 Python 设计 模式 》 | 《Flask Web 开 发 : 
《Python 编程 入 门 (第 3 版 ) 》 基于 Python 的 Web 应 用 开发 实战 》 
-|《Python 性 能 分 析 与 优化 》 
| 《Python 计算 机 视觉 编程 》 


-| 《Python 数据 挖掘 入 门 与 实践 》 
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看 完了 


如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com， 会 有 编辑 或 作 
译 者 协助 答疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨论 。 


如 果 是 有 关 电 子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮箱 : 


ebook@turingbook.com。 
在 这 可 以 找到 我 们 : 


微 博 @ 图 灵 教育 : 好 书 、 活 动 每 日 播报 

微 博 @ 图 灵 社 区 : 电子 书 和 好 文章 的 消息 

微 博 @ 图 灵 新 知 : 图 灵 教 育 的 科普 小 组 

微 信 图 灵 访 谈 : ituring_interview， 讲 述 码 农 精彩 人 生 
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